Partager via


CommandText, propriété (ADO)

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 ("").

Notes

Utilisez la propriété CommandText pour définir ou retourner 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é Prepared 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 la méthode Execute ou Open.

Selon le paramétrage de la propriété CommandType, ADO peut modifier la propriété CommandText. Vous pouvez lire la propriété CommandText à tout moment pour voir le texte de commande réel qu’ADO utilisera lors de l’exécution.

Utilisez la propriété CommandText pour définir ou retourner une URL relative spécifiant 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.

Remarque

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 à

Command, objet (ADO)

Voir aussi

Exemple de propriétés ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction (VB)
Exemple de propriétés ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction (VC++)
Requery, méthode
Exemple de propriétés ActiveConnection, CommandText, CommandTimeout, CommandType, Size et Direction (JScript)