SqlCommand.CommandText Propriété

Définition

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.Gets or sets the Transact-SQL statement, table name or stored procedure to execute at the data source.

public:
 property System::String ^ CommandText { System::String ^ get(); void set(System::String ^ value); };
[System.Data.DataSysDescription("DbCommand_CommandText")]
public string CommandText { get; set; }
member this.CommandText : string with get, set
Public Property CommandText As String

Valeur de propriété

Instruction Transact-SQL ou procédure stockée à exécuter.The Transact-SQL statement or stored procedure to execute. La valeur par défaut est une chaîne vide.The default is an empty string.

Implémente

Attributs

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.

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é CommandType est définie sur StoredProcedure, la propriété CommandText doit être définie sur le nom de la procédure stockée.When the CommandType property is set to StoredProcedure, the CommandText property should be set to the name of the stored procedure. L’utilisateur peut être amené à utiliser la syntaxe caractère d’échappement si le nom de la procédure stockée contient des caractères spéciaux.The user may be required to use escape character syntax if the stored procedure name contains any special characters. La commande exécute cette procédure stockée lorsque vous appelez l’une des méthodes Execute.The command executes this stored procedure when you call one of the Execute methods.

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 le passage de paramètres à une instruction Transact-SQL ou à une procédure stockée appelée par une commande de CommandType.Text.The Microsoft .NET Framework Data Provider for SQL Server does not support the question mark (?) placeholder for passing parameters to a Transact-SQL statement or a stored procedure called by a command of CommandType.Text. Dans ce cas, les paramètres nommés doivent être utilisés.In this case, named parameters must be used. Par exemple :For example:

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.For more information, see Configuring Parameters and Parameter Data Types.

S’applique à

Voir aussi