Partager via

Méthode Execute (connexion ADO)

  • Article

S’applique à : Access 2013 | Access 2016

Exécute la requête, l’instruction SQL, la procédure stockée ou le texte propre au fournisseur spécifiés.

Syntaxe

Pour une chaîne de commande ne retournant pas de ligne :

connexion. ExécuterCommandText, RecordsAffected, Options

Pour une chaîne de commande retournant des lignes :

Définir laconnexionau jeu d’enregistrements = .Execute( CommandText, RecordsAffected, Options )

Valeur renvoyée

Retourne une référence d'objet Recordset.

Paramètres

  • CommandText

    • Valeur de type String contenant l'instruction SQL, la procédure stockée, une URL ou un texte propre au fournisseur à exécuter. Des noms de table peuvent également être fournis, mais seulement si le fournisseur est compatible SQL. Par exemple, si vous utilisez le nom de table « Customers », ADO ajoute automatiquement la syntaxe SQL Select standard afin de créer et de passer « SELECT * FROM Customers » en tant qu'instruction T-SQL au fournisseur.

  • RecordsAffected

    • Facultatif. Variable de type Long dans laquelle le fournisseur retourne le nombre d'enregistrements affectés par l'opération.

  • Options

    • Optional. Valeur de type Long qui indique de quelle façon le fournisseur doit évaluer l’argument CommandText. Il peut s’agir d’un masque de bits comprenant une ou plusieurs valeurs CommandTypeEnum ou ExecuteOptionEnum.

Remarque

Utilisez la valeur ExecuteOptionEnum adExecuteNoRecords pour améliorer les performances en réduisant le traitement interne.

N’utilisez pas les valeurs CommandTypeEnum de adCmdFile ou adCmdTableDirect avec Execute. Ces valeurs peuvent être uniquement utilisées en tant qu’options avec les méthodes Open et Requery d’un objet Recordset.

Remarques

L’utilisation de la méthode Execute sur un objet Connection exécute la requête que vous passez à la méthode dans l’argument CommandText sur la connexion spécifiée. Si l’argument CommandText spécifie une requête de retour de ligne, tous les résultats générés par l’exécution sont stockés dans un nouvel objet Recordset . Si la commande n’est pas destinée à retourner des résultats (par exemple, une requête SQL UPDATE), le fournisseur retourne Nothing tant que l’option adExecuteNoRecords est spécifiée ; sinon, Execute retourne un recordset fermé.

L’objet Recordset retourné correspond toujours à un curseur en lecture seule et avant uniquement. Si vous avez besoin d’un objet Recordset avec davantage de fonctionnalités, commencez par créer un objet Recordset avec les paramètres de propriétés requis, puis utilisez la méthode Open de l’objet Recordset pour exécuter la requête et retourner le type de curseur souhaité.

Le contenu de l'argument CommandText est propre au fournisseur et peut correspondre à une syntaxe SQL standard ou à tout format de commande spécial pris en charge par le fournisseur.

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

Remarque

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

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.