Exemples
GetRows
Cet exemple montre comment utiliser la méthode GetRows.
objet Recordset
L'objet ADO Recordset est utilisé pour maintenir un ensemble d'enregistrements d'une table de base de données. Un objet d' enregistrements se composent d'enregistrements et de colonnes (fields) .
Dans ADO, cet objet est le plus important et celui qui est utilisé le plus souvent pour manipuler des données à partir d'une base de données.
ProgID
set objRecordset=Server.CreateObject("ADODB.recordset")
Lorsque vous ouvrez un Recordset, le pointeur d'enregistrement courant pointera vers le premier enregistrement et la BOF et les propriétés EOF sont fausses. S'il n'y a pas de dossiers, le BOF et la propriété EOF sont vraies.
les objets Recordset peuvent supporter deux types de mise à jour:
- Immediate updating à Immediate updating - toutes les modifications sont écrites immédiatement à la base de données une fois que vous appelez la méthode de mise à jour.
- La Batch updating à Batch updating par Batch updating - le fournisseur en cache plusieurs modifications, puis les envoyer à la base de données avec la méthode UpdateBatch.
Dans ADO il y a 4 différents types de curseurs définis:
- Dynamic cursor - Permet de voir les ajouts, modifications et suppressions par d' autres utilisateurs.
- Keyset cursor - Comme un curseur dynamique, sauf que vous ne pouvez pas voir les ajouts par d' autres utilisateurs, et il empêche l' accès aux dossiers que d' autres utilisateurs ont supprimés. Les modifications de données par d'autres utilisateurs seront toujours visibles.
- Static cursor - Fournit une copie statique d'un jeu d' enregistrements pour vous d'utiliser pour trouver des données ou générer des rapports. Les ajouts, modifications ou suppressions par d'autres utilisateurs ne seront pas visibles. Ceci est le seul type de curseur autorisé lorsque vous ouvrez un objet Recordset côté client.
- Forward-only cursor - Permet de ne faire défiler en avant par le Recordset. Les ajouts, modifications ou suppressions par d'autres utilisateurs ne seront pas visibles.
Le type de curseur peut être défini par la propriété CursorType ou par le paramètre CursorType dans la méthode Open.
Note: Tous les fournisseurs prennent en charge toutes les méthodes ou les propriétés de l'objet Recordset.
Propriétés
| Propriété | La description |
|---|---|
| AbsolutePage | Définit ou retourne une valeur qui spécifie le numéro de page dans l'objet Recordset |
| AbsolutePosition | Définit ou retourne une valeur qui spécifie la position ordinale de l'enregistrement en cours dans l'objet Recordset |
| ActiveCommand | Renvoie l'objet de commande associé au Recordset |
| ActiveConnection | Définit ou retourne une définition pour une connexion si la connexion est fermée, ou l'objet courant de connexion si la connexion est ouverte |
| BOF | Renvoie true si la position de l'enregistrement en cours est avant le premier enregistrement, sinon faux |
| Bookmark | Définit ou retourne un signet. Le signet enregistre la position de l'enregistrement en cours |
| CacheSize | Définit ou retourne le nombre d'enregistrements qui peuvent être mises en cache |
| CursorLocation | Définit ou retourne l'emplacement du service du curseur |
| CursorType | Définit ou retourne le type de curseur d'un objet Recordset |
| DataMember | Définit ou retourne le nom du membre de données qui seront extraites de l'objet référencé par la propriété DataSource |
| DataSource | Spécifie un objet contenant des données à être représenté comme un objet d'enregistrements |
| EditMode | Renvoie l'état d'édition de l'enregistrement en cours |
| EOF | Renvoie true si la position de l'enregistrement en cours est après le dernier enregistrement, sinon faux |
| Filter | Définit ou renvoie un filtre pour les données dans un objet d'enregistrements |
| Index | Définit ou retourne le nom de l'index courant pour un objet Recordset |
| LockType | Définit ou retourne une valeur qui spécifie le type de verrouillage lors de la modification d'un enregistrement dans un Recordset |
| MarshalOptions | Définit ou retourne une valeur qui spécifie les enregistrements doivent être retournés au serveur |
| MaxRecords | Définit ou retourne le nombre maximum d'enregistrements pour revenir à un objet Recordset d'une requête |
| PageCount | Renvoie le nombre de pages avec des données dans un objet Recordset |
| PageSize | Définit ou retourne le nombre maximum d'enregistrements autorisés sur une seule page d'un objet Recordset |
| RecordCount | Retourne le nombre d'enregistrements dans un objet Recordset |
| Sort | Définit ou renvoie le nom de champ dans le Recordset à trier |
| Source | Définit une valeur de chaîne ou un objet de commande de référence, 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 d'enregistrements est ouverte, fermée, de connexion, d'exécution ou de la récupération des données |
| Status | Renvoie l'état de l'enregistrement en cours en ce qui concerne les mises à jour par lots ou d'autres opérations en vrac |
| StayInSync | Définit ou retourne si la référence aux enregistrements enfants changeront lorsque les changements de position de l'enregistrement parent |
méthodes
| méthode | La description |
|---|---|
| AddNew | Crée un nouveau record |
| Cancel | Annule l'exécution |
| CancelBatch | Pour annuler une mise à jour batch |
| CancelUpdate | Pour annuler les modifications apportées à un enregistrement d'un objet Recordset |
| Clone | Crée un double d'un Recordset existant |
| Close | Ferme un Recordset |
| CompareBookmarks | Deux signets Compare |
| Delete | Supprime un enregistrement ou d'un groupe d'enregistrements |
| Find | Recherche un enregistrement dans une Recordset qui satisfait à un critère spécifié |
| GetRows | Des copies des enregistrements multiples d'un objet d'enregistrements dans un tableau à deux dimensions |
| GetString | Retourne une chaîne Recordset comme |
| Move | Déplace le pointeur d'enregistrement dans un objet Recordset |
| MoveFirst | Déplace le pointeur d'enregistrement au premier enregistrement |
| MoveLast | Déplace le pointeur d'enregistrement au dernier enregistrement |
| MoveNext | Déplace le pointeur d'enregistrement à l'enregistrement suivant |
| MovePrevious | Déplace le pointeur d'enregistrement à l'enregistrement précédent |
| NextRecordset | Efface l'objet d'enregistrements en cours et renvoie l'objet suivant d'enregistrements en boucle à travers une série de commandes |
| Open | Ouvre un élément de base de données qui vous donne accès à des enregistrements dans une table, les résultats d'une requête, ou à un Recordset sauvé |
| Requery | Met à jour les données dans un Recordset par re-exécution de la requête qui a fait l'objet Recordset d'origine |
| Resync | Actualise les données du Recordset courant de la base de données d'origine |
| Save | Enregistre un objet Recordset à un fichier ou un objet Stream |
| Seek | Recherche dans l'index d'un Recordset pour trouver un enregistrement qui correspond aux valeurs spécifiées |
| Supports | Renvoie une valeur booléenne qui indique si oui ou non un objet Recordset prend en charge un type de fonctionnalité spécifique |
| Update | Enregistre toutes les modifications apportées à un seul enregistrement dans un objet Recordset |
| UpdateBatch | Enregistre toutes les modifications dans un jeu d'enregistrements à la base de données. Utilisé lorsque vous travaillez en mode de mise à jour batch |
Événements
Note: Vous ne pouvez pas gérer les événements à l' aide de VBScript ou JScript (uniquement Visual Basic, Visual C ++ et Visual J ++ langues peuvent gérer les événements).
| un événement | La description |
|---|---|
| EndOfRecordset | Déclenché lorsque vous essayez de passer à un niveau record après le dernier enregistrement |
| FetchComplete | Déclenché après tous les enregistrements d'une opération asynchrone ont été récupérés |
| FetchProgress | Déclenché périodiquement dans une opération asynchrone, de dire combien d'autres enregistrements qui ont été récupérés |
| FieldChangeComplete | Déclenché après que la valeur d'un changement d'objet Field |
| MoveComplete | Déclenché après la position actuelle dans le Recordset a changé |
| RecordChangeComplete | Déclenché après un enregistrement a changé |
| RecordsetChangeComplete | Déclenché après l'Recordset a changé |
| WillChangeField | Déclenché avant que la valeur d'un changement d'objet Field |
| WillChangeRecord | Déclenché avant un changement d'enregistrement |
| WillChangeRecordset | Déclenché avant un changement Recordset |
| WillMove | Déclenché avant la position actuelle dans les changements Recordset |
collections
| Collection | La description |
|---|---|
| Fields | Indique le nombre d'objets sur le terrain dans l'objet Recordset |
| Properties | Contient tous les objets de propriété dans l'objet Recordset |
Les propriétés de la collection Champs
| Propriété | La description |
|---|---|
| Count | Retourne le nombre d'éléments dans la collection de champs. Commence à zéro. Exemple: countfields = rs.Fields.Count |
| Item(named_item/number) | Renvoie un élément spécifié dans la collection de champs. Exemple: itemfields = rs.Fields. Item(1) |
Les propriétés de la collection de propriétés
| Propriété | La description |
|---|---|
| Count | Renvoie le nombre d'éléments de la collection de propriétés. Commence à zéro. Exemple: countprop = rs.Properties.Count |
| Item(named_item/number) | Renvoie un élément spécifié dans la collection de propriétés. Exemple: itemprop = rs.Properties. Item(1) |