Execute, méthode (objet Connection ADO)

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

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 Object (ADO).

Paramètres

CommandText
Valeur Chaîne qui contient l’instruction SQL, la procédure stockée, une URL ou un texte spécifique au fournisseur à exécuter. Si vous le souhaitez, les noms de table peuvent être utilisés, mais uniquement si le fournisseur est conscient de SQL. Par exemple, si un nom de table « Customers » est utilisé, ADO ajoute automatiquement la syntaxe SQL Select standard pour former et passer « SELECT * FROM Customers » en tant qu’instruction Transact-SQL au fournisseur.

RecordsAffected
facultatif. Variable longue à laquelle le fournisseur retourne le nombre d’enregistrements affectés par l’opération.

Options
facultatif. Une valeur longue qui indique comment le fournisseur doit évaluer l'argument CommandText. Il peut s’agir d’un masque de bits d’une ou de plusieurs valeurs CommandTypeEnum ou ExecuteOptionEnum .

Note Utilisez la valeur ExecuteOptionEnumadExecuteNoRecords pour améliorer les performances en réduisant le traitement interne et pour les applications que vous transférez à partir de Visual Basic 6.0.

N’utilisez pas adExecuteStream avec la méthode Execute d’un objet Connection .

N'utilisez pas les valeurs CommandTypeEnum de adCmdFile ou adCmdTableDirect avec Execute. Ces valeurs peuvent uniquement être utilisées comme options avec les méthodes Méthode Ouvrir (ADO Recordset) et Méthode Requête d'un Recordset.

Notes

L’utilisation de la méthode Exécuter sur un objet Objet Connection (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 ne retourne rien tant que l’option adExecuteNoRecords est spécifiée ; sinon, Execute retourne un Recordset fermé.

L’objet Recordset retourné est toujours un curseur en lecture seule et avant uniquement. Si vous avez besoin d’un objet Recordset avec plus de fonctionnalités, commencez par créer un objet Recordset avec les paramètres de propriété souhaités, puis utilisez la méthode Open Method (ADO Recordset) de l’objet Recordset pour exécuter la requête et retourner 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.

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 à

Connection, objet (ADO)