CommandText, propriété (ADO)

  • Article

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

Paramètres et valeurs de retour

Obtient ou définit une valeur String contenant une commande 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 . Il s’agira généralement d’une instruction SQL, mais ce peut également être n’importe quel autre type d’instruction de commande reconnu par le fournisseur, comme un appel de procédure stockée. Une instruction SQL doit être du dialecte ou de la version spécifiques 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.

Notes

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)