SqlCommand.CommandText Propriété

Référence

Définition

Espace de noms:: System.Data.SqlClient

Assembly:: System.Data.SqlClient.dll

Assembly:: System.Data.dll

Assemblys:: netstandard.dll, System.Data.SqlClient.dll

Paquet:: System.Data.SqlClient v4.8.6

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.

Obtient ou définit l'instruction Transact-SQL, le nom de table ou la procédure stockée à exécuter au niveau de la source de données.

public:
 virtual property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };

public override string CommandText { get; set; }

[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }

member this.CommandText : string with get, set

[<System.Data.DataSysDescription("DbCommand_CommandText")>]
member this.CommandText : string with get, set

Public Overrides Property CommandText As String

Public Property CommandText As String

Valeur de propriété

String

Instruction Transact-SQL ou procédure stockée à exécuter. La valeur par défaut est une chaîne vide.

Implémente

CommandText

Attributs: DataSysDescriptionAttribute

Exemples

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

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

Public Sub CreateCommand()
    Dim command As New SqlCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 15
    command.CommandType = CommandType.Text
End Sub

Remarques

Lorsque la propriété a la CommandTypeStoredProcedurevaleur , la CommandText propriété doit être définie sur le nom de la procédure stockée. L’utilisateur peut être amené à utiliser la syntaxe des caractères d’échappement si le nom de la procédure stockée contient des caractères spéciaux. La commande exécute cette procédure stockée lorsque vous appelez l’une Execute des méthodes.

Le fournisseur de données Microsoft .NET Framework pour SQL Server ne prend pas en charge l’espace réservé de point d’interrogation ( ?) pour passer des paramètres à une instruction Transact-SQL ou à une procédure stockée appelée par une commande de CommandType.Text. Dans ce cas, des paramètres nommés doivent être utilisés. Exemple :

SELECT * FROM dbo.Customers WHERE CustomerID = @CustomerID

Pour plus d’informations, consultez Configuration des paramètres et des types de données de paramètre.

S’applique à

Partager via