Partager via

Méthode Execute (commande ADO)

  • Article

S’applique à : Access 2013 | Access 2016

Exécute la requête, l’instruction SQL ou la procédure stockée spécifiée dans la propriété CommandText.

Syntaxe

Pour un objet Command retournant un objet Recordset:

Pour un objet Command ne retournant pas un objet Recordset:

Valeur renvoyée

Retourne une référence d’objet Recordset ou Nothing.

Parameters

  • RecordsAffected

    • Facultatif. Variable de type Long dans laquelle le fournisseur retourne le nombre d’enregistrements affectés par l’opération. Le paramètre RecordsAffected ne vaut que pour les requêtes d’action et les procédures stockées. RecordsAffected ne retourne pas le nombre d’enregistrements renvoyés par une requête qui retourne des résultats ou une procédure stockée. Pour obtenir ces informations, utilisez la propriété RecordCount. La méthode Execute ne renverra pas les informations appropriées lorsqu’elle est utilisée avec adAsyncExecute, tout simplement parce que lorsqu’une commande est exécutée de manière asynchrone, le nombre d’enregistrements affectés n’est peut-être pas connu au moment où la méthode retourne des résultats.

  • Parameters

    • Facultatif. Tableau de type Variant contenant les valeurs de paramètre passées à l'aide d'une instruction SQL. (Les paramètres de sortie ne retournent pas de valeurs correctes lorsqu'ils sont passés dans cet argument.)

  • Options

    • Facultatif. Valeur de type Long qui indique de quelle façon le fournisseur doit évaluer la propriété CommandText de l’objet Command. Il peut s’agir d’une valeur de masque de bits obtenue à l’aide de valeurs CommandTypeEnum et/ou ExecuteOptionEnum. Par exemple, vous pouvez utiliser adCmdText et adExecuteNoRecords ensemble si vous voulez qu’ADO évalue la valeur de la propriété CommandText en tant que texte et indique que la commande doit annuler (et ne pas renvoyer) tous les enregistrements susceptibles d’être générés lorsque le texte de commande est exécuté.

Remarques

L'utilisation de la méthode Execute sur un objet Command exécute la requête spécifiée dans la propriété CommandText de l'objet. Si la propriété CommandText spécifie une requête qui retourne des lignes, tous les résultats générés par l'exécution de la commande sont stockés dans un nouvel objet Recordset. Si la commande ne correspond pas à ce type de requête, le fournisseur retourne un objet Recordset fermé. Certains langages d'application vous permettent d'ignorer cette valeur de retour si vous ne souhaitez pas obtenir d'objet Recordset.

Si la requête contient des paramètres, les valeurs actuelles des paramètres de l'objet Command sont utilisées sauf si vous les remplacez par les valeurs de paramètres passées avec l'appel de la méthode Execute. Vous pouvez omettre un sous-ensemble de paramètres en ne spécifiant pas de nouvelles valeurs pour certains paramètres lorsque vous appelez la méthode Execute. L'ordre dans lequel vous spécifiez les paramètres est le même que celui dans lequel la méthode les passe. Par exemple, s’il y avait quatre paramètres (ou plus) et que vous souhaitez transmettre de nouvelles valeurs uniquement pour les premier et quatrième paramètres, vous devez passer en tant qu’argument Parameters .

Remarque

Les paramètres de sortie ne retournent pas de valeurs correctes lorsqu'ils sont passés dans l'argument Parameters.

Un événement ExecuteComplete est déclenché au terme de cette opération.

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.