<Complete Référence objet de connexion
Un événement est un sous-programme qui peut être appelé automatiquement après a eu lieu une opération spécifique.
- Le WillExecute événement peut être tiré juste avant un appel à objcomm.Execute, objconn.Execute ou objrs.Open.
- Le ExecuteComplete événement peut être tiré après un appel à objcomm.Execute, objconn.Execute, objrs.Open, objrs.Requery ou objrs.NextRecordset est terminé.
Syntaxe
WillExecute src,cursortyp,locktyp,options,
status,objcomm,objrs,objconn
ExecuteComplete recaffected,objerror,status,
objcomm,objrs,objconn
| Paramètre | La description |
|---|---|
| src | Une chaîne contenant une commande SQL ou le nom de la procédure stockée |
| cursortyp | Indique le type de curseur à utiliser. L' une des CursorTypeEnum valeurs |
| locktyp | Indique le type de verrouillage à utiliser. L' une des LockTypeEnum valeurs |
| options | Un ou plusieurs des CommandTypeEnum ou ExecuteOptionEnum valeurs |
| recaffected | Le nombre d'enregistrements affectés par l'exécution |
| objerror | Un objet d'erreur qui contient les erreurs survenues Note: La valeur EventStatusEnum doit être réglé sur adStatusErrorsOccurred pour créer l'objet d'erreur |
| status | Une EventStatusEnum valeur |
| objcomm | Pour WillExecute : Définir l'objet de commande qui a été exécuté ou rien Pour ExecuteComplete : L'objet de commande qui a été exécuté |
| objrs | Pour WillExecute : Réglez l'objet Recordset qui a résulté de l'exécution de la commande ou rien Pour ExecuteComplete : L'objet Recordset qui est le résultat de la commande exécutée |
| objconn | L'objet de connexion qui est associée à l'exécution de la commande |
valeurs CursorTypeEnum
Spécifie le type de curseur utilisé dans un objet d'enregistrements.
| Constante | Valeur | La description |
|---|---|---|
| adOpenUnspecified | -1 | Ne précise pas le type de curseur. |
| adOpenForwardOnly | 0 | Défaut. Utilise un curseur avant uniquement. Identique à un curseur statique, sauf que vous ne pouvez faire défiler vers l'avant dans les dossiers. Cela améliore les performances lorsque vous devez faire une seule passe à travers un Recordset. |
| adOpenKeyset | 1 | Utilise un curseur keyset. Comme un curseur dynamique, sauf que vous ne pouvez pas voir les enregistrements que d'autres utilisateurs ajoutent, bien que les enregistrements que d'autres utilisateurs de suppression sont inaccessibles à partir de votre Recordset. Les modifications de données par d'autres utilisateurs sont encore visibles. |
| adOpenDynamic | 2 | Utilise un curseur dynamique. Les ajouts, modifications et suppressions par d'autres utilisateurs sont visibles, et tous les types de mouvement à travers le Recordset sont autorisés, à l'exception des signets, si le fournisseur ne les supporte pas. |
| adOpenStatic | 3 | Utilise un curseur statique. Une copie statique d'un ensemble d'enregistrements que vous pouvez utiliser pour trouver des données ou générer des rapports. Les ajouts, modifications ou suppressions par d'autres utilisateurs ne sont pas visibles. |
valeurs LockTypeEnum
| Constante | Valeur | La description |
|---|---|---|
| adLockUnspecified | -1 | Ne spécifie pas un type de serrure. Pour les clones, le clone est créé avec le même type de verrou que l'original. |
| adLockReadOnly | 1 | Indique en lecture seule des enregistrements. Vous ne pouvez pas modifier les données. |
| adLockPessimistic | 2 | Indique le verrouillage pessimiste, enregistrement par enregistrement. Le fournisseur fait ce qui est nécessaire pour assurer l'édition réussie des dossiers, généralement en bloquant les enregistrements à la source de données immédiatement après l'édition. |
| adLockOptimistic | 3 | Indique le verrouillage optimiste, enregistrement par enregistrement. Le fournisseur utilise le verrouillage optimiste, verrouillage des enregistrements uniquement lorsque vous appelez la méthode de mise à jour. |
| adLockBatchOptimistic | 4 | Indique les mises à jour par lots optimistes. Obligatoire pour le mode de mise à jour batch. |
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 | 16 | Indique que la commande doit exécuter de manière asynchrone. Cette valeur ne peut être combinée avec la adCmdTableDirect valeur CommandTypeEnum. |
| adAsyncFetch | 32 | 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 | 64 | 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 | 128 | 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 | 256 | 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 | 512 | 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. |
valeurs EventStatusEnum
| Constante | Valeur | La description |
|---|---|---|
| adStatusOK | 1 | L'opération qui a déclenché l'événement a été un succès |
| adStatusErrorsOccurred | 2 | L'opération qui a déclenché l'événement ayant échoué |
| adStatusCantDeny | 3 | Impossible d'annuler l'opération en attente |
| adStatusCancel | 4 | Annule l'opération qui a déclenché l'événement |
| adStatusUnwantedEvent | 5 | Prévient les notifications ultérieures avant que la méthode de l'événement a terminé son exécution |
<Complete Référence objet de connexion