SqlCommand.CommandText Propriété

Définition

Espace de noms:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paquet:

Microsoft.Data.SqlClient v5.2.0

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 override string CommandText { get; set; }

member this.CommandText : string with get, set

Public Overrides 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.

Exemples

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

// <Snippet1>
using System;
using System.Xml;
using System.Data;
using Microsoft.Data.SqlClient;
using System.Data.Common;
using System.Windows.Forms;

public class Form1 : Form
{
    protected DataSet DataSet1;
    protected DataGrid dataGrid1;

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

}

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.