Partage via

CommandText, propriété (ADO)

  • Article

Indique le texte d’une commande à émettre sur un fournisseur.

Paramètres et valeurs de retour

Obtient ou définit une valeur String qui contient une commande de fournisseur, telle qu’une instruction SQL, un nom de table, une URL relative ou un appel de procédure stockée. La valeur par défaut est la chaîne vide ( » « ).

Remarques

Utilisez la propriété CommandText pour définir ou renvoyer le texte d’une commande représentée par un objet Command. En règle générale, il s’agit d’une instruction SQL, mais peut également être n’importe quel autre type d’instruction de commande reconnu par le fournisseur, tel qu’un appel de procédure stockée. Une instruction SQL doit être du dialecte ou de la version spécifique pris en charge par le processeur de requêtes du fournisseur.

Si la propriété Prepare de l’objet Command a la valeur True et que l’objet Command est lié à une connexion ouverte lorsque vous définissez la propriété CommandText, ADO prépare la requête (autrement dit, une forme compilée de la requête stockée par le fournisseur) lorsque vous appelez les méthodes Execute ou Open.

En fonction du paramètre de propriété CommandType, ADO peut modifier la propriété CommandText. Vous pouvez lire la propriété CommandText à tout moment pour afficher le texte de commande réel utilisé par ADO pendant l’exécution.

Utilisez la propriété CommandText pour définir ou retourner une URL relative qui spécifie une ressource, telle qu’un fichier ou un répertoire. La ressource est relative à un emplacement spécifié explicitement par une URL absolue ou implicitement par un objet Connection ouvert.

Note

Les URL utilisant le schéma http appellent automatiquement le fournisseur Microsoft OLE DB pour la publication Internet. Pour plus d’informations, consultez URL absolues et relatives.

S’applique à

objet de commande (ADO)

Voir aussi

ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction Properties Example (VB)
ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction, Propriétés - Exemple (VC++)
méthode Requery
ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction Properties Example (JScript)