Execute, méthode (connexion ADO)
Exécute la requête, l’instruction SQL, la procédure stockée ou le texte spécifique au fournisseur spécifié.
Syntaxe
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)
Set recordset = connection.Execute (CommandText, RecordsAffected, Options)
Valeur de retour
Renvoie une référence d’objet Recordset (ADO).
Paramètres
CommandText
Valeur String qui contient l’instruction SQL, la procédure stockée, une URL ou un texte spécifique au fournisseur à exécuter.
Éventuellement, les noms de tables peuvent être utilisés, mais uniquement si le fournisseur est conscient de SQL. Par exemple, si un nom de table « Customers » est utilisé, ADO précède automatiquement la syntaxe SQL Select standard pour former et transmettre « SELECT * FROM Customers » en tant qu’instruction Transact-SQL au fournisseur.
RecordsAffected
Optionnel. Variable long à laquelle le fournisseur retourne le nombre d’enregistrements affectés par l’opération.
options
Optionnel. Valeur long qui indique comment le fournisseur doit évaluer l’argument CommandText. Il peut s’agir d’un masque de bits d’une ou plusieurs valeurs CommandTypeEnum ou ExecuteOptionEnum.
Remarque Utiliser la valeur ExecuteOptionEnumadExecuteNoRecords pour améliorer les performances en réduisant le traitement interne et pour les applications que vous effectuez le portage à partir de Visual Basic 6.0.
N’utilisez pas adExecuteStream avec la méthode Execute d’un objet Connection Connection.
N’utilisez pas les valeurs CommandTypeEnum d’adCmdFile ou adCmdTableDirect avec Execute. Ces valeurs ne peuvent être utilisées que comme options avec l'Open Method (ADO Recordset) et méthode Requery d’un jeu d’enregistrements .
Remarques
L’utilisation de la méthode Execute sur un objet Connection Object (ADO) exécute la requête que vous transmettez à 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 les 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 jeu d’enregistrements fermé.
L’objet Recordset retourné est toujours un curseur en lecture seule et en avant uniquement. Si vous avez besoin d’un objet Recordset avec plus de fonctionnalités, créez d’abord un objet Recordset avec les paramètres de propriété souhaités, puis utilisez le jeu d’enregistrementsméthode Open Method (ADO Recordset) de l’objet pour exécuter la requête et renvoyer le type de curseur souhaité.
Le contenu de l’argument CommandText est spécifique au fournisseur et peut être une syntaxe SQL standard ou tout format de commande spécial pris en charge par le fournisseur.
Un événement ExecuteComplete est émis lorsque cette opération se termine.
Note
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.