objet ADO Recordset
Exemples
GetRows
Cet exemple montre comment utiliser la méthode GetRows.
objet Recordset
objet ADO Recordset est utilisé pour maintenir un ensemble d'enregistrements d'une table de base de données. Un objet Recordset se compose de documents et des colonnes (champs) composants.
Dans ADO, cet objet est les données les plus importantes et les plus fréquemment utilisés dans les objets de base de données pour fonctionner.
ProgID
Lorsque vous ouvrez un jeu d'enregistrements, le pointeur d'enregistrement courant pointer vers le premier enregistrement, et BOF et EOF propriété est False. S'il n'y a pas des dossiers, BOF et la propriété EOF sur True.
objets Recordset peuvent soutenir deux types de mises à jour:
- Mise à jour - une fois que vous appelez la méthode de mise à jour, toutes les modifications sont immédiatement écrites dans la base de données. Mise à jour de lot - fournisseur met en cache plusieurs modifications, puis utiliser la méthode UpdateBatch pour transférer les modifications à la base de données.
Dans ADO, nous définissons quatre autre curseur (pointeur) type:
- curseur dynamique - Vous permet de voir d'autres utilisateurs d'ajouter, de modifier et de supprimer
- curseur Keyset - curseur dynamique similaire, sauf que vous ne pouvez pas voir les autres utilisateurs que vous avez ajoutés, et il vous empêcher d'accéder à un autre utilisateur supprimé les enregistrements. Les modifications de données faites par d'autres utilisateurs sont encore visibles.
- curseur statique - Fournit une copie statique d'un jeu d'enregistrements peut être utilisé pour trouver des données ou générer des rapports. En outre, l'addition faite par d'autres utilisateurs, modifier et supprimer ne seront pas visibles. Lorsque vous ouvrez un objet Recordset côté client, qui est le seul type de curseur autorisé.
- Forward seulement curseurs - autoriser uniquement défiler vers l'avant à travers le Recordset. En outre, l'addition faite par d'autres utilisateurs, modifier et supprimer ne seront pas visibles.
Type de curseur peut être réglé via la propriété CursorType ou méthode Open paramètre CursorType.
Remarque: Tous les fournisseurs (fournisseurs) méthodes et propriétés de soutien de l' objet Recordset.
propriété
propriété | description |
---|---|
AbsolutePage | Définit ou retourne une valeur spécifiée nombre d'enregistrements de la page d'objet. |
AbsolutePosition | Définit ou retourne une valeur qui peut être spécifiée position ordinale d'enregistrement actuel (ordinal poste) Recordset objet. |
ActiveCommand | Renvoie l'objet Recordset objets de commande associés. |
ActiveConnection | Si la connexion est coupée, ou revenir à définir la connexion, si la connexion est ouverte, définit ou retourne l'objet de connexion en cours. |
BOF | Si la position de l'enregistrement en cours est avant le premier enregistrement, il retourne vrai, sinon Fasle. |
Bookmark | Définit ou renvoie un signet. Marquer cet emplacement pour enregistrer l'enregistrement en cours. |
CacheSize | Définit ou retourne le nombre d'enregistrements qui peuvent être mis en cache. |
CursorLocation | Définit ou renvoie la position du service de curseur. |
CursorType | Définit ou renvoie le type d'un objet Recordset du curseur. |
DataMember | Définit ou retourne le nom de l'objet de l'élément de données propriété DataSource référencé récupéré. |
DataSource | Indique un fichier contenant l'objet à être représenté comme les données d'un objet Recordset. |
EditMode | Retour à la modification du statut de l'enregistrement en cours. |
EOF | Si l'enregistrement en cours après le dernier enregistrement, il retourne vrai, sinon Fasle. |
filtre | Renvoie un objet Recordset pour le filtre de données. |
index | Définit ou retourne le nom de l'index de l'objet Recordset en cours. |
LockType | Définit ou retourne Recordset lors de la modification d'un enregistrement, la valeur de la serrure de type spécifié. |
MarshalOptions | Définit ou retourne une valeur qui spécifie les enregistrements sont renvoyés au serveur. |
MaxRecords | Définit ou renvoie une requête qui renvoie un objet Recordset à partir du nombre maximal d'enregistrements. |
NbPages | Renvoie un objet Recordset pages de données. |
PageSize | Définit ou retourne le nombre maximum d'enregistrements sur une seule page objet Recordset permet. |
RecordCount | Retourne le nombre d'enregistrements dans un objet Recordset. |
trier | Définit ou retourne une ou plusieurs références comme noms de champ de tri d'enregistrements. |
source | Définition d'une valeur de chaîne, ou une référence d'objet de commande, ou renvoie une valeur de chaîne qui peut indiquer l'objet Recordset de source de données. |
état | Elle renvoie une valeur qui peut décrire si l'objet Recordset est ouvert, fermé, connexion, en cours ou récupérer des données. |
statut | Retour des mises à jour par lots ou d'autres opérations en vrac liées à l'état de l'enregistrement en cours. |
StayInSync | Définit ou retourne lorsque la paire enregistrées lorsque la position de l'enregistrement parent change de référence est modifié. |
manière
manière | description |
---|---|
AddNew | Créer un nouveau record. |
annuler | Annuler la dernière exécution. |
CancelBatch | Annuler la dernière mise à jour batch. |
CancelUpdate | Retrait d'un enregistrement dans l'objet Recordset changements. |
cloner | Créer une copie d'un Recordset existant. |
proche | Fermeture d'un Recordset. |
CompareBookmarks | Compare deux signets. |
effacer | Supprimer un enregistrement ou d'un groupe d'enregistrements. |
trouver | Rechercher un Recordset qui satisfait à une condition spécifiée dans un enregistrement. |
GetRows | Plusieurs copies des enregistrements à partir d'un objet Recordset dans un tableau à deux dimensions. |
GetString | Le Recordset est retourné comme une chaîne. |
déménagement | Dans l'objet Recordset pour déplacer le pointeur d'enregistrement. |
MoveFirst | Le pointeur d'enregistrement au premier enregistrement. |
MoveLast | Le pointeur d'enregistrement au dernier enregistrement. |
MoveNext | Le pointeur d'enregistrement se déplace à l'enregistrement suivant. |
MovePrevious | Déplacez le pointeur d'enregistrement à l'enregistrement précédent. |
NextRecordset | Efface l'objet Recordset en cours en exécutant une série de commandes et retourne la prochaine Recordset. |
ouvert | Ouvrez un élément de base de données, qui fournit un enregistrement de la table, les résultats d'une requête ou un accès Recordset stocké. |
Requery | Pour mettre à jour les données dans un objet Recordset en ré-exécuter la requête à base d'objets. |
Resync | Actualiser les données dans le Recordset en cours à partir de la base de données originale. |
Sauvegarder | objet Recordset pour enregistrer l'objet de fichier ou Stream. |
chercher | recherche d'index Recordset pour localiser rapidement la valeur spécifiée correspond à la ligne et rend la ligne actuelle. |
Supports | Elle renvoie une valeur booléenne qui définit si un objet Recordset prend en charge un type spécifique de fonctionnalité. |
mettre à jour | Enregistrer toutes les modifications apportées à un seul enregistrement dans l'objet Recordset. |
UpdateBatch | Tous les changements Recordset stockés dans la base de données. Utilisation en mode de mise à jour batch. |
événement
Remarque: Vous pouvez utiliser VBScript ou JScript processus (permet seulement Visual Basic, Visual C ++, et J ++ événements Visual de traitement du langage).
événement | description |
---|---|
EndOfRecordset | Lorsque vous essayez d'aller au-delà de la fin de la ligne Recordset est déclenchée. |
FetchComplete | Lorsque l'opération asynchrone déclenchée après que tous les enregistrements sont lus. |
FetchProgress | Être déclenché périodiquement pendant une opération asynchrone, il rend compte combien d'enregistrements ont été lus. |
FieldChangeComplete | Modifiez la valeur d'un objet de champ est déclenché. |
MoveComplete | Recordset les changements de position actuelle après la gâchette. |
RecordChangeComplete | Après un enregistrement est déclenché le changement. |
RecordsetChangeComplete | Elle est déclenchée après que les changements Recordset. |
WillChangeField | Être déclenchée avant que la valeur de l'objet change de terrain |
WillChangeRecord | Il est déclenché avant un changement d'enregistrement. |
WillChangeRecordset | Il est déclenché avant que les modifications Recordset. |
WillMove | Recordset est déclenchée avant que les changements de position actuelle. |
ensemble
ensemble | description |
---|---|
Les champs | Il indique le nombre de cet objet sur le terrain de l'objet Recordset. |
Propriétés | Il contient tous les objets de la propriété de l'objet Recordset. |
collection Fields Propriété
propriété | description |
---|---|
compter | Retourne le nombre de champs dans la collection d'éléments. Commence à zéro. Exemples: countfields = rs.Fields.Count |
Point (named_item / nombre) | Renvoie les champs dans la collection d'un élément spécifié. Exemples: itemfields = rs.Fields.Item(1) 或者 itemfields = rs.Fields.Item("Name") |
collection Properties Propriétés
propriété | description |
---|---|
compter | Retourne le nombre d'éléments dans une collection de propriétés. Commence à zéro. Exemples: countprop = rs.Properties.Count |
Point (named_item / nombre) | Renvoie les propriétés d'un élément spécifié dans la collection. Exemples: itemprop = rs.Properties.Item(1) 或者 itemprop = rs.Properties.Item("Name") |