Exécution de la méthode (commande ADO)

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

Syntaxe

  
Set recordset = command.Execute( RecordsAffected, Parameters, Options )  

Valeur de retour

Renvoie une référence d’objet Recordset , un flux ou Nothing.

Paramètres

RecordsAffected
Optionnel. Variable long à laquelle le fournisseur retourne le nombre d’enregistrements affectés par l’opération. Le paramètre RecordsAffected s’applique uniquement aux requêtes d’action ou aux procédures stockées. RecordsAffected ne retourne pas le nombre d’enregistrements retournés par une requête de retour de résultat ou une procédure stockée. Pour obtenir ces informations, utilisez la propriété RecordCount . La méthode Execute ne retourne pas les informations correctes lorsqu’elle est utilisée avec adAsyncExecute, simplement parce qu’une commande est exécutée de manière asynchrone, le nombre d’enregistrements affectés peut ne pas encore être connu au moment où la méthode retourne.

Paramètres
Optionnel. Tableau variant de valeurs de paramètre utilisées conjointement avec la chaîne d’entrée ou le flux spécifié dans CommandText ou CommandStream. (Les paramètres de sortie ne retournent pas les valeurs correctes lorsqu’ils sont passés dans cet argument.)

Options
Optionnel. Valeur longue qui indique comment le fournisseur doit évaluer commandText ou la propriété CommandStream de l’objet Command . Il peut s’agir d’une valeur de masque de bits effectuée à l’aide de valeurs CommandTypeEnum et/ou ExecuteOptionEnum . Par exemple, vous pouvez utiliser adCmdText et adExecuteNoRecords en combinaison si ADO évalue la valeur de la propriété CommandText en tant que texte et indique que la commande doit ignorer et ne retourner aucun enregistrement susceptible d’être généré lorsque le texte de la commande s’exécute.

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 ou la propriété CommandStream de l’objet.

Les résultats sont retournés dans un recordset (par défaut) ou sous forme de flux d’informations binaires. Pour obtenir un flux binaire, spécifiez adExecuteStream dans Options, puis fournissez un flux en définissant Command.Properties(« Output Stream »). Un objet ADO Stream peut être spécifié pour recevoir les résultats, ou un autre objet de flux tel que l’objet Réponse IIS peut être spécifié. Si aucun flux n’a été spécifié avant d’appeler Execute avec adExecuteStream, une erreur se produit. La position du flux à retourner à partir d’Execute est spécifique au fournisseur.

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é. Certaines langues d’application vous permettent d’ignorer cette valeur de retour si aucun recordset n’est souhaité.

L’exécution génère une erreur si l’utilisateur spécifie une valeur pour CommandStream lorsque commandType est adCmdStoredProc, adCmdTable ou adCmdTableDirect.

Si la requête a des paramètres, les valeurs actuelles des paramètres de l’objet Command sont utilisées, sauf si vous remplacez ces valeurs par des valeurs de paramètre passées avec l’appel d’exécution . Vous pouvez remplacer un sous-ensemble des paramètres en omettant de nouvelles valeurs pour certains des paramètres lors de l’appel de la méthode Execute . L’ordre dans lequel vous spécifiez les paramètres est le même dans lequel la méthode les transmet. Par exemple, s’il y avait quatre paramètres (ou plus) et que vous souhaitiez passer de nouvelles valeurs uniquement pour les premiers et quatrième paramètres, vous passeriez Array(var1,,,var4) en tant qu’argument Parameters .

Un événement ExecuteComplete est émis lorsque cette opération se termine.

S’applique à

objet de commande (ADO)

Voir aussi

Execute, Requery et Clear, méthodes - Exemple (VB)
Execute, Requery et Clear, méthodes - Exemple (VBScript)
Execute, Requery et Clear, méthodes - Exemple (VC++)
CommandStream, propriété (ADO)
CommandText, propriété (ADO)
CommandTypeEnum
Execute, méthode (connexion ADO)
d’événement ExecuteComplete (ADO)