<Complete Référence objet de commande
La méthode d'exécution exécute la requête, l'instruction SQL ou d'une procédure spécifiée dans la propriété CommandText de l'objet Command.
Les résultats sont stockés dans un nouvel objet Recordset si elle est une requête de ligne-retour. Un objet Recordset fermé sera retourné si elle n'est pas une requête de ligne-retour.
Syntaxe de ligne-retour
Set rs=objcommand.Execute(ra,parameters,options)
Syntaxe de non-retour ligne
objcommand.Execute ra,parameters,options
| Paramètre | La description |
|---|---|
| ra | Optionnel. Renvoie le nombre d'enregistrements affectés par une requête. Pour une requête de ligne-retour, utilisez la propriété RecordCount de l'objet Recordset à compter de combien d'enregistrements sont l'objet. |
| parameters | Optionnel. Les valeurs des paramètres passés avec une instruction SQL. Permet de modifier, mettre à jour ou insérer de nouvelles valeurs de paramètre dans la collection Paramètres. |
| options | Optionnel. Définit comment le fournisseur doit évaluer la propriété CommandText. Peut - être un ou plusieurs CommandTypeEnum ou ExecuteOptionEnum valeurs. Par défaut est adCmdUnspecified. |
Exemple
<%
Set objcommand.CommandText="SELECT * FROM Customers"
objCommand.Execute
%>
or
<%
Set objcommand.CommandText="Customers"
objCommand.Execute(,,adCmdTableDirect)
%>
valeurs CommandTypeEnum
| Constante | Valeur | La description |
|---|---|---|
| adCmdUnspecified | -1 | Ne précise pas l'argument de type de commande. |
| adCmdText | 1 | Évalue CommandText comme une définition textuelle d'une commande ou appel de procédure stockée. |
| adCmdTable | 2 | Évalue CommandText comme nom de la table dont les colonnes sont toutes retournées par une requête SQL généré en interne. |
| adCmdStoredProc | 4 | Évalue CommandText comme nom de procédure stockée. |
| adCmdUnknown | 8 | Indique que le type de commande dans la propriété CommandText est inconnue. |
| adCmdFile | 256 | Évalue CommandText comme nom de fichier d'un Recordset persistant stocké. Utilisé avec Recordset.Open ou Requery seulement. |
| adCmdTableDirect | 512 | Évalue CommandText comme nom de la table dont les colonnes sont toutes retournées. Utilisé avec Recordset.Open ou Requery seulement. Pour utiliser la méthode Seek, le Recordset doit être ouvert avec adCmdTableDirect. Cette valeur ne peut être combinée à la valeur ExecuteOptionEnum adAsyncExecute. |
valeurs ExecuteOptionEnum
| Constante | Valeur | La description |
|---|---|---|
| adOptionUnspecified | -1 | Indique que la commande est non spécifiée. |
| adAsyncExecute | Indique que la commande doit exécuter de manière asynchrone. Cette valeur ne peut être combinée avec la adCmdTableDirect valeur CommandTypeEnum. | |
| adAsyncFetch | Indique que les lignes restantes après la quantité initiale spécifiée dans la propriété CacheSize doivent être récupérées de façon asynchrone. | |
| adAsyncFetchNonBlocking | Indique que le thread principal ne bloque jamais lors de la récupération. Si la ligne demandée n'a pas été récupéré, la ligne actuelle se déplace automatiquement à la fin du fichier. Si vous ouvrez un Recordset à partir d'un flux contenant un Recordset constamment stocké, adAsyncFetchNonBlocking aura pas d'effet; l'opération sera synchrone et le blocage. adAsynchFetchNonBlocking n'a pas d'effet lorsque l'option adCmdTableDirect est utilisée pour ouvrir le Recordset. | |
| adExecuteNoRecords | Indique que le texte de commande est une commande ou une procédure stockée qui ne renvoie pas de lignes (for example, a command that only inserts data) les (for example, a command that only inserts data) . Si toutes les lignes sont récupérés, ils sont mis au rebut et non retournés. adExecuteNoRecords ne peut être transmis en tant que paramètre facultatif à la commande ou la connexion méthode Execute. | |
| adExecuteStream | Indique que les résultats d'une exécution de la commande doivent être renvoyés en cours d'eau. adExecuteStream ne peut être passé comme paramètre optionnel à la méthode Exécuter la commande. | |
| adExecuteRecord | Indique que le CommandText est une commande ou une procédure stockée qui renvoie une seule ligne qui doit être retourné comme un objet Record. |
<Complete Référence objet de commande