ADO RecordsetObjet
Exemple
GetRows
Cet exemple montre comment utiliser la méthode GetRows.
Objet Recordset
L'objet Recordset ADO est utilisé pour contenir un ensemble d'enregistrements d'une table de base de données. Un objet Recordset est constitué d'enregistrements et de colonnes (champs).
Dans ADO, cet objet est le plus important et le plus fréquemment utilisé pour manipuler des données dans une base de données.
ProgID
Lorsque vous ouvrez un Recordset pour la première fois, le pointeur d'enregistrement courant pointe vers le premier enregistrement, et les propriétés BOF et EOF sont False. S'il n'y a aucun enregistrement, les propriétés BOF et EOF sont True.
L'objet Recordset peut prendre en charge deux types de mises à jour :
- Mise à jour immédiate - Dès que vous appelez la méthode Update, toutes les modifications sont écrites immédiatement dans la base de données. Mise à jour par lot - Le fournisseur met en cache plusieurs modifications, puis utilise la méthode UpdateBatch pour transférer ces modifications vers la base de données.
Dans ADO, quatre types de curseurs (pointeurs) différents sont définis :
- Curseur dynamique - Vous permet de visualiser les ajouts, les modifications et les suppressions effectués par d'autres utilisateurs.
- Curseur keyset - Semblable à un curseur dynamique, sauf que vous ne pouvez pas voir les ajouts effectués par d'autres utilisateurs, et il vous empêche d'accéder aux enregistrements que d'autres utilisateurs ont supprimés. Les modifications de données effectuées par d'autres utilisateurs restent visibles.
- Curseur statique - Fournit une copie statique du Recordset, qui peut être utilisée pour rechercher des données ou générer des rapports. De plus, les ajouts, modifications et suppressions effectués par d'autres utilisateurs ne seront pas visibles. Lorsque vous ouvrez un objet Recordset côté client, il s'agit du seul type de curseur autorisé.
- Curseur avant uniquement - Autorise uniquement le défilement vers l'avant dans le Recordset. De plus, les ajouts, modifications et suppressions effectués par d'autres utilisateurs ne seront pas visibles.
Le type de curseur peut être défini via la propriété CursorType ou le paramètre CursorType de la méthode Open.
Remarque :Tous les fournisseurs ne prennent pas en charge toutes les méthodes et propriétés de l'objet Recordset.
Propriétés
| Propriété | Description |
|---|---|
| AbsolutePage | Définit ou renvoie une valeur qui spécifie le numéro de page dans un objet Recordset. |
| AbsolutePosition | Définit ou renvoie une valeur qui spécifie la position séquentielle (position ordinale) de l'enregistrement actif dans un objet Recordset. |
| ActiveCommand | Renvoie l'objet Command associé à l'objet Recordset. |
| ActiveConnection | Si la connexion est fermée, définit ou renvoie la définition de connexion ; si la connexion est ouverte, définit ou renvoie l'objet Connection actuel. |
| BOF | Renvoie true si la position de l'enregistrement actif est avant le premier enregistrement ; sinon, renvoie false. |
| Bookmark | Définit ou renvoie un signet. Ce signet enregistre la position de l'enregistrement actif. |
| CacheSize | Définit ou renvoie le nombre d'enregistrements qui peuvent être mis en cache. |
| CursorLocation | Définit ou renvoie l'emplacement du service de curseur. |
| CursorType | Définit ou renvoie le type de curseur d'un objet Recordset. |
| DataMember | Définit ou renvoie le nom du membre de données à récupérer à partir de l'objet référencé par la propriété DataSource. |
| DataSource | Spécifie un objet qui contient des données à représenter sous forme d'objet Recordset. |
| EditMode | Renvoie l'état de modification de l'enregistrement actif. |
| EOF | Renvoie true si la position de l'enregistrement actif se trouve après le dernier enregistrement ; sinon, renvoie false. |
| Filter | Renvoie un filtre pour les données d'un objet Recordset. |
| Index | Définit ou renvoie le nom de l'index actuel d'un objet Recordset. |
| LockType | Définit ou renvoie une valeur qui spécifie le type de verrouillage lors de la modification d'un enregistrement dans un Recordset. |
| MarshalOptions | Définit ou renvoie une valeur qui spécifie quels enregistrements sont renvoyés au serveur. |
| MaxRecords | Définit ou renvoie le nombre maximal d'enregistrements à renvoyer à un objet Recordset à partir d'une requête. |
| PageCount | Renvoie le nombre de pages de données dans un objet Recordset. |
| PageSize | Définit ou renvoie le nombre maximal d'enregistrements autorisés sur une seule page d'un objet Recordset. |
| RecordCount | Renvoie le nombre d'enregistrements dans un objet Recordset. |
| Sort | Définit ou renvoie un ou plusieurs noms de champs sur lesquels le Recordset est trié. |
| Source | Définit une valeur de chaîne ou une référence à un objet Command, ou renvoie une valeur de chaîne qui indique la source de données de l'objet Recordset. |
| State | Renvoie une valeur qui décrit si l'objet Recordset est ouvert, fermé, en cours de connexion, d'exécution ou d'extraction de données. |
| Status | Renvoie l'état de l'enregistrement actif en ce qui concerne les mises à jour par lots ou d'autres opérations en bloc. |
| StayInSync | Définit ou renvoie si la référence aux enregistrements enfants change lorsque la position de l'enregistrement parent change. |
Méthodes
| Méthodes | Description |
|---|---|
| AddNew | Crée un nouvel enregistrement. |
| Cancel | Annule une exécution. |
| CancelBatch | Annule une mise à jour par lots. |
| CancelUpdate | Annule les modifications apportées à un enregistrement dans un objet Recordset. |
| Clone | Crée une copie d'un Recordset existant. |
| Close | Ferme un Recordset. |
| CompareBookmarks | Compare deux signets. |
| Delete | Supprime un enregistrement ou un groupe d'enregistrements. |
| Find | Recherche un enregistrement dans un Recordset qui répond à une condition spécifiée. |
| GetRows | Copie plusieurs enregistrements d'un objet Recordset vers un tableau à deux dimensions. |
| GetString | Renvoie le Recordset sous forme de chaîne. |
| Move | Déplace le pointeur d'enregistrement dans un objet Recordset. |
| MoveFirst | Déplace le pointeur d'enregistrement vers le premier enregistrement. |
| MoveLast | Déplace le pointeur d'enregistrement vers le dernier enregistrement. |
| MoveNext | Déplace le pointeur d'enregistrement vers l'enregistrement suivant. |
| MovePrevious | Déplace le pointeur d'enregistrement vers l'enregistrement précédent. |
| NextRecordset | Efface l'objet Recordset actuel et renvoie le Recordset suivant en exécutant une série de commandes. |
| Open | Ouvre un élément de base de données qui donne accès aux enregistrements de table, aux résultats de requête ou à un Recordset enregistré. |
| Requery | Met à jour les données d'un objet Recordset en réexécutant la requête sur laquelle l'objet est basé. |
| Resync | Actualise les données du Recordset actuel à partir de la base de données d'origine. |
| Save | Enregistre l'objet Recordset dans un fichier ou un objet Stream. |
| Seek | Recherche dans l'index du Recordset pour localiser rapidement une ligne qui correspond à la valeur spécifiée et en faire la ligne active. |
| Supports | Renvoie une valeur booléenne qui définit si l'objet Recordset prend en charge un type spécifique de fonctionnalité. |
| Update | Enregistre toutes les modifications apportées à un seul enregistrement dans un objet Recordset. |
| UpdateBatch | Enregistre toutes les modifications du Recordset dans la base de données. À utiliser en mode de mise à jour par lot. |
Événements
Remarque : vous ne pouvez pas utiliser VBScript ou JScript pour gérer les événements (seuls les langages Visual Basic, Visual C++ et Visual J++ sont autorisés à gérer les événements).
| Événements | Description |
|---|---|
| EndOfRecordset | Déclenché lors d'une tentative de déplacement au-delà de la fin du Recordset. |
| FetchComplete | Déclenché après la lecture de tous les enregistrements d'une opération asynchrone. |
| FetchProgress | Déclenché périodiquement pendant une opération asynchrone, en indiquant le nombre d'enregistrements lus. |
| FieldChangeComplete | Déclenché lorsque la valeur d'un objet Field change. |
| MoveComplete | Déclenché après le changement de la position actuelle dans le Recordset. |
| RecordChangeComplete | Déclenché après la modification d'un enregistrement. |
| RecordsetChangeComplete | Déclenché après la modification d'un Recordset. |
| WillChangeField | Déclenché avant la modification de la valeur d'un objet Field. |
| WillChangeRecord | Déclenché avant la modification d'un enregistrement. |
| WillChangeRecordset | Déclenché avant la modification du Recordset. |
| WillMove | Déclenché avant que la position actuelle dans le Recordset ne change. |
Collections
| Set | Description |
|---|---|
| Fields | Indique le nombre d'objets Field dans cet objet Recordset. |
| Propriétés | Contient les objets Property dans tous les objets Recordset. |
Propriétés de la collection Fields
| Attribut | Description |
|---|---|
| Count |
Renvoie le nombre d'éléments dans la collection fields. Commence à 0. Exemple : countfields = rs.Fields.Count |
| Item(named_item/number) |
Renvoie un élément spécifié dans la collection Fields. Exemple : itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
Propriétés de la collection Properties
| attribut | Description |
|---|---|
| Count |
Renvoie le nombre d'éléments dans la collection properties. Commence à 0. Exemple : countprop = rs.Properties.Count |
| Item(named_item/number) |
Renvoie un élément spécifié dans la collection properties. Exemple : itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |