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

set objRecordset=Server.CreateObject("ADODB.recordset")

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")
Autres extensions.