<Complete Référence objet de connexion
La méthode d'exécution exécute une requête spécifiée, l'instruction SQL, procédure stockée, ou d'un texte spécifique au fournisseur.
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.
Note: Le retour est toujours Recordset en lecture seule, avant uniquement Recordset!
Tip: Pour créer un jeu d' enregistrements avec plus de fonctionnalités, d' abord créer un objet Recordset. Définissez les propriétés souhaitées, puis utilisez la méthode Open de l'objet Recordset pour exécuter la requête.
Syntaxe de ligne-retour
Set objrs=objconn.Execute(commandtext,ra,options)
Syntaxe de non-retour ligne
objconn.Execute commandtext,ra,options
| Paramètre | La description |
|---|---|
| commandtext | Champs obligatoires. L'instruction SQL, la procédure stockée ou d'un texte spécifique au fournisseur d'exécuter |
| ra | Optionnel. Le nombre d'enregistrements affectés par la requête |
| options | Optionnel. Définit comment le fournisseur doit évaluer le paramètre CommandText. Peut - être un ou plusieurs CommandTypeEnum ou ExecuteOptionEnum valeurs. Par défaut est adCmdUnspecified |
Exemple
<%
sql="SELECT companyname FROM Customers"
Set rs=conn.Execute(sql)
%>
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 connexion