Execute, méthode (commande ADO)

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

Syntaxe

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

Valeur de retour

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

Paramètres

RecordsAffected
facultatif. Variable longue à laquelle le fournisseur retourne le nombre d’enregistrements affectés par l’opération. Le paramètre RecordsAffected s’applique uniquement à des requêtes d’action ou à des procédures stockées. Le paramètre RecordsAffected ne retourne pas le nombre d’enregistrements retournés par une requête ou une procédure stockée retournant un résultat. Pour obtenir ces informations, utilisez la propriété RecordCount. La méthode Execute ne retourne pas les informations correctes quand elle est utilisée avec l’option adAsyncExecute, du simple fait que, quand 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
facultatif. Un tableau Variant de valeurs de paramètres utilisées conjointement avec la chaîne d’entrée ou le flux spécifié dans la propriété CommandText ou CommandStream (les paramètres de sortie ne retournent pas de valeurs correctes quand ils sont passés dans cet argument).

Options
facultatif. Une valeur Long indiquant comment le fournisseur devrait évaluer la propriété commandText ou CommandStream de l’objet Command. Il peut s’agir d’une valeur de masque de bits créée à l’aide des valeurs CommandTypeEnum et/ou ExecuteOptionEnum. Par exemple, vous pouvez utiliser les commandes adCmdText et adExecuteNoRecords combinées si vous souhaitez qu’ADO évalue la valeur de la propriété CommandText en tant que texte, et indique que la commande devrait ignorer et ne retourner aucun enregistrement qui pourrait être généré lors de l’exécution du texte de la commande.

Notes

Utilisez la valeur ExecuteOptionEnumadExecuteNoRecords pour améliorer les performances en minimisant le traitement interne. Si adExecuteStream a été spécifié, les options adAsyncFetch et adAsynchFetchNonBlocking sont ignorées. N’utilisez pas les valeurs CommandTypeEnum d’adCmdFile, ou adCmdTableDirect avec la méthode Execute. Ces valeurs ne peuvent être utilisées que comme options avec les méthodes Open et Requery d’un objet Recordset.

Notes

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 objet Recordset (par défaut) ou sous la forme d’un flux d’informations binaires. Pour obtenir un flux binaire, dans Options, spécifiez adExecuteStream, 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 flux tel que l’objet Réponse IIS. Si aucun flux n’a été spécifié avant d’appeler la méthode Execute avec adExecuteStream, une erreur se produit. La position du flux dans le retour de la méthode d’Execute est spécifique du fournisseur.

Si la commande n’est pas destinée à retourner des résultats (par exemple, une requête SQL UPDATE), le fournisseur ne retourne rien tant que l’option adExecuteNoRecords est spécifiée. Sinon, la méthode Execute retourne un objet Recordset fermé. Certains langages d’application permettent d’ignorer cette valeur de retour si aucun objet Recordset n’est souhaité.

La méthode Execute lève une erreur si l’utilisateur spécifie une valeur pour CommandStream que le 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 les remplacez par les valeurs de paramètre passées avec l’appel de la méthode Execute. Vous pouvez remplacer un sous-ensemble des paramètres en omettant de nouvelles valeurs pour certains 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 que celui dans lequel la méthode les passe. Par exemple, s’il y avait quatre paramètres (ou plus) et que vous souhaitiez passer de nouvelles valeurs uniquement pour les premier et quatrième paramètres, vous passeriez Array(var1,,,var4) en tant qu’argument Parameters.

Notes

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

Un événement ExecuteComplete sera émis à la fin de cette opération.

Notes

Lors de l’émission de commandes contenant des URL, celles 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.

S'applique à

Command, objet (ADO)

Voir aussi

Exemple des méthodes Execute, Requery et Clear (VB)
Exemple des méthodes Execute, Requery et Clear (VBScript)
Exemple Execute, Requery et Clear (VC++)
CommandStream, propriété (ADO)
CommandText, propriété (ADO)
CommandTypeEnum
Execute, méthode (objet Connection ADO)
ExecuteComplete, événement (ADO)