SqlCommand Constructeurs
Définition
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.
Initialise une nouvelle instance de la classe SqlCommand.
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()
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é.
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 présente les valeurs de propriété initiales d’une instance de SqlCommand.
| Properties | 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 par le biais d’un appel distinct à la propriété.
Voir aussi
S’applique à
SqlCommand(String)
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 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 la 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’une instance est SqlCommand créée, les propriétés de lecture/écriture suivantes sont définies sur les valeurs initiales.
| Properties | Valeur initiale |
|---|---|
| CommandText | cmdText |
| CommandTimeout | 30 |
| CommandType | CommandType.Text |
| Connection | zéro |
Vous pouvez modifier la valeur de l’une de ces propriétés par le biais d’un appel distinct à la propriété.
Voir aussi
- Connexion et récupération de données dans ADO.NET
- Utilisation du fournisseur de données .NET Framework pour SQL Server
- Vue d'ensemble d’ADO.NET
S’applique à
SqlCommand(String, SqlConnection)
Initialise une nouvelle instance de la SqlCommand classe 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 une SqlCommand valeur 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 présente les valeurs de propriété initiales d’une instance de SqlCommand.
| Properties | 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
- Connexion et récupération de données dans ADO.NET
- Utilisation du fournisseur de données .NET Framework pour SQL Server
- Vue d'ensemble d’ADO.NET
S’applique à
SqlCommand(String, SqlConnection, SqlTransaction)
Initialise une nouvelle instance de la SqlCommand classe avec le texte de la requête, un SqlConnectionet le 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 s’exécute l’exécutionSqlCommand.
Remarques
Le tableau suivant présente les valeurs de propriété initiales d’une instance de SqlCommand.
| Properties | 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
- Connexion et récupération de données dans ADO.NET
- Utilisation du fournisseur de données .NET Framework pour SQL Server
- Vue d'ensemble d’ADO.NET
S’applique à
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.
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 s’exécute l’exécutionSqlCommand.
- columnEncryptionSetting
- SqlCommandColumnEncryptionSetting
Paramètre de chiffrement. Pour plus d'informations, consultez Always Encrypted.