SqlCommand Constructeurs

Définition

Espace de noms:: Microsoft.Data.SqlClient

Assembly:: Microsoft.Data.SqlClient.dll

Paquet:: Microsoft.Data.SqlClient v1.0.19269.1

Paquet:: Microsoft.Data.SqlClient v1.1.4

Paquet:: Microsoft.Data.SqlClient v2.0.1

Paquet:: Microsoft.Data.SqlClient v2.1.4

Paquet:: Microsoft.Data.SqlClient v3.0.1

Paquet:: Microsoft.Data.SqlClient v3.1.0

Paquet:: Microsoft.Data.SqlClient v4.0.1

Paquet:: Microsoft.Data.SqlClient v4.1.0

Paquet:: Microsoft.Data.SqlClient v5.0.0

Paquet:: Microsoft.Data.SqlClient v5.1.0

Paquet:: Microsoft.Data.SqlClient v5.2.0

Paquet:: Microsoft.Data.SqlClient v6.0.2

Paquet:: Microsoft.Data.SqlClient v6.1.3

Paquet:: Microsoft.Data.SqlClient v7.0.1

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Surcharges

Nom	Description
SqlCommand()	Initialise une nouvelle instance de la classe SqlCommand.
SqlCommand(String)	Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête.
SqlCommand(String, SqlConnection)	Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête et un SqlConnection.
SqlCommand(String, SqlConnection, SqlTransaction)	Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête, un SqlConnectionet le SqlTransaction.
SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)	Initialise une nouvelle instance de la classe avec le texte de commande, la connexion, la SqlCommand transaction et le paramètre de chiffrement spécifiés.

SqlCommand()

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Initialise une nouvelle instance de la classe SqlCommand.

public:
 SqlCommand();

public SqlCommand();

Public Sub New ()

Exemples

L’exemple suivant crée une SqlCommand propriété et définit la CommandTimeout propriété.

using System;
using System.Xml;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;
using Microsoft.Data.SqlClient;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

    public void CreateSqlCommand()
    {
        SqlCommand command = new SqlCommand();
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
}

Remarques

Le constructeur de base initialise tous les champs à leurs valeurs par défaut. Le tableau suivant présente les valeurs de propriété initiales d’une instance de SqlCommand.

Propriétés	Valeur initiale
CommandText	chaîne vide (« »)
CommandTimeout	30
CommandType	Text
Connection	`null`

Vous pouvez modifier la valeur de l’une de ces propriétés par le biais d’un appel distinct à la propriété.

S’applique à

SqlCommand(String)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête.

public:
 SqlCommand(System::String ^ cmdText);

public SqlCommand(string cmdText);

new Microsoft.Data.SqlClient.SqlCommand : string -> Microsoft.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String)

Paramètres

cmdText: String

Texte de la requête.

Exemples

L’exemple suivant crée un SqlCommand, en passant le texte de la commande.

using System;
using System.Xml;
using System.Data;
using System.Data.Common;
using System.Windows.Forms;
using Microsoft.Data.SqlClient;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

    public void CreateCommand()
    {
        string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
        SqlCommand command = new SqlCommand(queryString);
        command.CommandTimeout = 15;
        command.CommandType = CommandType.Text;
    }
}

Remarques

Lorsqu’une instance est SqlCommand créée, les propriétés de lecture/écriture suivantes sont définies sur les valeurs initiales.

Propriétés	Valeur initiale
CommandText	`cmdText`
CommandTimeout	30
CommandType	Text
Connection	`null`

Vous pouvez modifier la valeur de l’une de ces propriétés par le biais d’un appel distinct à la propriété.

S’applique à

SqlCommand(String, SqlConnection)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête et un SqlConnection.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection);

public SqlCommand(string cmdText, Microsoft.Data.SqlClient.SqlConnection connection);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection -> Microsoft.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection)

Paramètres

cmdText: String

Texte de la requête.

connection: SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.

Exemples

L’exemple suivant crée une SqlCommand valeur et définit certaines de ses propriétés.

using System;
using System.Data;
using Microsoft.Data.SqlClient;

namespace SqlCommandCS
{
    class Program
    {
        static void Main()
        {
            string str = "Data Source=(local);Initial Catalog=Northwind;"
                + "Integrated Security=SSPI";
            string qs = "SELECT OrderID, CustomerID FROM dbo.Orders;";
            CreateCommand(qs, str);

        }

        private static void CreateCommand(string queryString, string connectionString)
        {
            using (SqlConnection connection = new SqlConnection(connectionString))
            {
                SqlCommand command = new SqlCommand(queryString, connection);
                connection.Open();
                SqlDataReader reader = command.ExecuteReader();
                while (reader.Read())
                {
                    Console.WriteLine(String.Format("{0}, {1}", reader[0], reader[1]));
                }
            }
        }
    }
}

Remarques

Le tableau suivant présente les valeurs de propriété initiales d’une instance de SqlCommand.

Propriétés	Valeur initiale
CommandText	`cmdText`
CommandTimeout	30
CommandType	Text
Connection	Nouveau SqlConnection qui est la valeur du `connection` paramètre.

Vous pouvez modifier la valeur de l’un de ces paramètres en définissant la propriété associée.

S’applique à

SqlCommand(String, SqlConnection, SqlTransaction)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête, un SqlConnectionet le SqlTransaction.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction);

public SqlCommand(string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction -> Microsoft.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

Paramètres

cmdText: String

Texte de la requête.

connection: SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.

transaction: SqlTransaction

SqlTransaction Dans lequel s’exécute l’exécutionSqlCommand.

Remarques

Le tableau suivant présente les valeurs de propriété initiales d’une instance de SqlCommand.

Propriétés	Valeur initiale
CommandText	`cmdText`
CommandTimeout	30
CommandType	Text
Connection	Nouveau SqlConnection qui est la valeur du `connection` paramètre.

Vous pouvez modifier la valeur de l’un de ces paramètres en définissant la propriété associée.

S’applique à

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Source:: SqlCommand.cs

Initialise une nouvelle instance de la classe avec le texte de commande, la connexion, la SqlCommand transaction et le paramètre de chiffrement spécifiés.

public:
 SqlCommand(System::String ^ cmdText, Microsoft::Data::SqlClient::SqlConnection ^ connection, Microsoft::Data::SqlClient::SqlTransaction ^ transaction, Microsoft::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);

public SqlCommand(string cmdText, Microsoft.Data.SqlClient.SqlConnection connection, Microsoft.Data.SqlClient.SqlTransaction transaction, Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);

new Microsoft.Data.SqlClient.SqlCommand : string * Microsoft.Data.SqlClient.SqlConnection * Microsoft.Data.SqlClient.SqlTransaction * Microsoft.Data.SqlClient.SqlCommandColumnEncryptionSetting -> Microsoft.Data.SqlClient.SqlCommand

Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction, columnEncryptionSetting As SqlCommandColumnEncryptionSetting)

Paramètres

cmdText: String

Texte de la requête.

connection: SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.

transaction: SqlTransaction

SqlTransaction Dans lequel s’exécute l’exécutionSqlCommand.

columnEncryptionSetting: SqlCommandColumnEncryptionSetting

Paramètre de chiffrement. Pour plus d'informations, consultez Always Encrypted.

S’applique à