SqlCommand Constructeurs

Définition

Initialise une nouvelle instance de la classe SqlCommand.

Surcharges

SqlCommand()

Initialise une nouvelle instance de la classe SqlCommand.

SqlCommand(String)

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

SqlCommand(String, SqlConnection)

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

SqlCommand(String, SqlConnection, SqlTransaction)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête, SqlConnection et 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.

SqlCommand()

Initialise une nouvelle instance de la classe SqlCommand.

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

Exemples

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

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. Le tableau suivant montre les valeurs de propriété initiales d’un instance de SqlCommand.

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

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.

Voir aussi

S’applique à

SqlCommand(String)

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

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.

Exemples

L’exemple suivant crée un SqlCommand, en passant le texte de chaîne de connexion et de commande.

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’un instance de SqlCommand est créé, les propriétés en lecture/écriture suivantes sont définies sur les valeurs initiales.

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

Vous pouvez modifier la valeur de l’une de ces propriétés via un appel distinct à la propriété.

Voir aussi

S’applique à

SqlCommand(String, SqlConnection)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête et un 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.

connection
SqlConnection

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

Exemples

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

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 montre les valeurs de propriété initiales d’un instance de SqlCommand.

Propriétés Valeur initiale
CommandText cmdText
CommandTimeout 30
CommandType 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.

Voir aussi

S’applique à

SqlCommand(String, SqlConnection, SqlTransaction)

Initialise une nouvelle instance de la classe SqlCommand avec le texte de la requête, SqlConnection et 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.

connection
SqlConnection

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

transaction
SqlTransaction

SqlTransaction dans lequel SqlCommand s’exécute.

Remarques

Le tableau suivant montre les valeurs de propriété initiales d’un instance de SqlCommand.

Propriétés Valeur initiale
CommandText cmdText
CommandTimeout 30
CommandType 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.

Voir aussi

S’applique à

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.

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.

connection
SqlConnection

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

transaction
SqlTransaction

SqlTransaction dans lequel SqlCommand s’exécute.

columnEncryptionSetting
SqlCommandColumnEncryptionSetting

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

S’applique à