Partager via


OleDbCommand.CommandText Propriété

Définition

Obtient ou définit l'instruction SQL 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é

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

Implémente

Attributs

Exemples

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

public void CreateMyOleDbCommand()
{
   OleDbCommand command = new OleDbCommand();
   command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID";
   command.CommandTimeout = 20;
}
Public Sub CreateMyOleDbCommand()
    Dim command As New OleDbCommand()
    command.CommandText = "SELECT * FROM Categories ORDER BY CategoryID"
    command.CommandTimeout = 20
End Sub

Remarques

Lorsque la propriété a la CommandTypeStoredProcedurevaleur , la CommandType 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 .

Lorsque CommandType a la TableDirectvaleur , la CommandType propriété doit être définie sur le nom de la ou des tables auxquelles accéder. L’utilisateur peut être amené à utiliser la syntaxe des caractères d’échappement si l’une des tables nommées contient des caractères spéciaux. Toutes les lignes et colonnes de la ou des tables nommées sont retournées lorsque vous appelez l’une Execute des méthodes.

Vous ne pouvez pas définir les Connectionpropriétés , CommandTypeet CommandText si la connexion actuelle effectue une opération d’exécution ou d’extraction.

Le fournisseur ole DB.NET ne prend pas en charge les paramètres nommés pour passer des paramètres à une instruction SQL ou à une procédure stockée appelée par un OleDbCommand quand CommandType est défini sur Text. Dans ce cas, l’espace réservé de point d’interrogation ( ?) doit être utilisé. Exemple :

SELECT * FROM Customers WHERE CustomerID = ?

Par conséquent, l’ordre dans lequel OleDbParameter les objets sont ajoutés à doit OleDbParameterCollection correspondre directement à la position de l’espace réservé de point d’interrogation pour le paramètre.

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

S’applique à

Voir aussi