SqlCommand Constructeurs

Définition

Initialise une nouvelle instance de la classe SqlCommand.Initializes a new instance of the SqlCommand class.

Surcharges

SqlCommand()

Initialise une nouvelle instance de la classe SqlCommand.Initializes a new instance of the SqlCommand class.

SqlCommand(String)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête.Initializes a new instance of the SqlCommand class with the text of the query.

SqlCommand(String, SqlConnection)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête et un SqlConnectionInitializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

SqlCommand(String, SqlConnection, SqlTransaction)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête, SqlConnection et SqlTransaction.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de commande, la connexion, la transaction et le paramètre de chiffrement spécifiés.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

SqlCommand()

Initialise une nouvelle instance de la classe SqlCommand.Initializes a new instance of the SqlCommand class.

public:
 SqlCommand();
public SqlCommand ();
Public Sub New ()

Exemples

L’exemple suivant crée une SqlCommand et définit la propriété CommandTimeout.The following example creates a SqlCommand and sets the CommandTimeout property.

public void CreateSqlCommand() 
{
   SqlCommand command = new SqlCommand();
   command.CommandTimeout = 15;
   command.CommandType = CommandType.Text;
}
Public Sub CreateSqlCommand()
    Dim command As New SqlCommand()
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Remarques

Le constructeur de base initialise tous les champs à leurs valeurs par défaut.The base constructor initializes all fields to their default values. Le tableau suivant indique les valeurs de propriétés initiales d’une instance de SqlCommand.The following table shows initial property values for an instance of SqlCommand.

PropriétésProperties Valeur initialeInitial value
CommandText chaîne vide ("")empty string ("")
CommandTimeout 3030
CommandType CommandType.Text
Connection NullNull

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel séparé à la propriété.You can change the value for any of these properties through a separate call to the property.

Voir aussi

SqlCommand(String)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête.Initializes a new instance of the SqlCommand class with the text of the query.

public:
 SqlCommand(System::String ^ cmdText);
public SqlCommand (string cmdText);
new System.Data.SqlClient.SqlCommand : string -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String)

Paramètres

cmdText
String

Texte de la requête.The text of the query.

Exemples

L’exemple suivant crée un SqlCommand, en passant la chaîne de connexion et le texte de la commande.The following example creates a SqlCommand, passing in the connection string and command text.

public void CreateCommand() 
 {
    string queryString = "SELECT * FROM Categories ORDER BY CategoryID";
    SqlCommand command = new SqlCommand(queryString);
    command.CommandTimeout = 15;
    command.CommandType = CommandType.Text;
 }
Public Sub CreateCommand()
    Dim queryString As String = "SELECT * FROM Categories ORDER BY CategoryID"
    Dim command As New SqlCommand(queryString)
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub 

Remarques

Lorsqu’une instance de SqlCommand est créée, les propriétés de lecture/écriture suivantes sont définies sur les valeurs initiales.When an instance of SqlCommand is created, the following read/write properties are set to initial values.

PropriétésProperties Valeur initialeInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection nullnull

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel séparé à la propriété.You can change the value for any of these properties through a separate call to the property.

Voir aussi

SqlCommand(String, SqlConnection)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête et un SqlConnectionInitializes a new instance of the SqlCommand class with the text of the query and a SqlConnection.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection)

Paramètres

cmdText
String

Texte de la requête.The text of the query.

connection
SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

Exemples

L’exemple suivant crée une SqlCommand et définit certaines de ses propriétés.The following example creates a SqlCommand and sets some of its properties.

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]));
        }
    }
}
Public Sub CreateCommand(ByVal queryString As String, _
  ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        Dim command As New SqlCommand(queryString, connection)

        connection.Open()
        Dim reader As SqlDataReader = command.ExecuteReader()
            While reader.Read()
            Console.WriteLine(String.Format("{0}, {1}", _
                reader(0), reader(1)))
        End While
    End Using
End Sub

Remarques

Le tableau suivant indique les valeurs de propriétés initiales d’une instance de SqlCommand.The following table shows initial property values for an instance of SqlCommand.

PropriétésProperties Valeur initialeInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Nouvelle SqlConnection qui correspond à la valeur du paramètre connection.A new SqlConnection that is the value for the connection parameter.

Vous pouvez modifier la valeur de l’un de ces paramètres en définissant la propriété associée.You can change the value for any of these parameters by setting the related property.

Voir aussi

SqlCommand(String, SqlConnection, SqlTransaction)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête, SqlConnection et SqlTransaction.Initializes a new instance of the SqlCommand class with the text of the query, a SqlConnection, and the SqlTransaction.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction -> System.Data.SqlClient.SqlCommand
Public Sub New (cmdText As String, connection As SqlConnection, transaction As SqlTransaction)

Paramètres

cmdText
String

Texte de la requête.The text of the query.

connection
SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

transaction
SqlTransaction

SqlTransaction dans lequel SqlCommand s’exécute.The SqlTransaction in which the SqlCommand executes.

Remarques

Le tableau suivant indique les valeurs de propriétés initiales d’une instance de SqlCommand.The following table shows initial property values for an instance of SqlCommand.

PropriétésProperties Valeur initialeInitial value
CommandText cmdText
CommandTimeout 3030
CommandType CommandType.Text
Connection Nouvelle SqlConnection qui correspond à la valeur du paramètre connection.A new SqlConnection that is the value for the connection parameter.

Vous pouvez modifier la valeur de l’un de ces paramètres en définissant la propriété associée.You can change the value for any of these parameters by setting the related property.

Voir aussi

SqlCommand(String, SqlConnection, SqlTransaction, SqlCommandColumnEncryptionSetting)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de commande, la connexion, la transaction et le paramètre de chiffrement spécifiés.Initializes a new instance of the SqlCommand class with specified command text, connection, transaction, and encryption setting.

public:
 SqlCommand(System::String ^ cmdText, System::Data::SqlClient::SqlConnection ^ connection, System::Data::SqlClient::SqlTransaction ^ transaction, System::Data::SqlClient::SqlCommandColumnEncryptionSetting columnEncryptionSetting);
public SqlCommand (string cmdText, System.Data.SqlClient.SqlConnection connection, System.Data.SqlClient.SqlTransaction transaction, System.Data.SqlClient.SqlCommandColumnEncryptionSetting columnEncryptionSetting);
new System.Data.SqlClient.SqlCommand : string * System.Data.SqlClient.SqlConnection * System.Data.SqlClient.SqlTransaction * System.Data.SqlClient.SqlCommandColumnEncryptionSetting -> System.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.The text of the query.

connection
SqlConnection

SqlConnection qui représente la connexion à une instance de SQL Server.A SqlConnection that represents the connection to an instance of SQL Server.

transaction
SqlTransaction

SqlTransaction dans lequel SqlCommand s’exécute.The SqlTransaction in which the SqlCommand executes.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

Paramètre de chiffrement.The encryption setting. Pour plus d’informations, consultez Always Encrypted.For more information, see Always Encrypted.

S’applique à