Propriété CommandText (ADO)

S’applique à : Access 2013, Office 2013

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

Paramètres et valeurs de retour

Définit ou renvoie une valeur de type String qui contient une commande de fournisseur, comme une instruction SQL, un nom de table, une URL relative ou un appel de procédure stockée. La valeur par défaut est "" (chaîne de longueur zéro).

Remarques

Utilisez la propriété CommandText pour définir ou renvoyer le texte d'une commande représentée par un objet Command. En général, il s'agit d'une instruction SQL, mais il peut également s'agir d'un autre type d'instruction de commande reconnu par le fournisseur, comme un appel de procédure stockée. Le langage, ou la version, utilisé pour une instruction SQL doit être 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 (c'est-à-dire, une forme compilée de la requête, qui est stockée par le fournisseur) lorsque vous appelez les méthodes Execute ou Open.

En fonction du paramètre de la propriété CommandType, ADO peut modifier la propriété CommandText. Vous pouvez lire la propriété CommandText à tout moment pour découvrir le texte réel de la commande utilisé par ADO au cours 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 spécifié implicitement par un objet Connection ouvert.