Membres de la classe CRecordset

Membres de données
Construction
Attributs de l'objet Recordset
Opérations de mise à jour de jeu d'enregistrements
Opérations de Navigation de jeu d'enregistrements
D'autres opérations de jeu d'enregistrements
Jeu d'enregistrements Overridables

Membres de données

m_hstmt Contient le handle d'instruction ODBC pour le jeu d'enregistrements. Type HSTMT.
m_nFields Contient le nombre de données membres de champ dans le jeu d'enregistrements. Type UINT.
m_nParams Contient le nombre de membres de données de paramètre dans l'objet recordset. Type UINT.
m_pDatabase Contient un pointeur vers l'objet CDatabase grâce auquel le jeu d'enregistrements est connecté à une source de données.
m_strFilter Contient un objet CString qui spécifie une clause Structured Query Language (SQL) . Utilisé comme un filtre pour sélectionner uniquement les enregistrements qui répondent à certains critères.
m_strSort Contient un objet CString qui spécifie une clause SQL ORDER BY . Utilisé pour contrôler la façon dont les enregistrements sont triés.

Construction

CRecordset Construit un objet CRecordset . Votre classe dérivée doit fournir un constructeur qui appelle un.
Ouvert Ouvre le recordset par extraction de la table ou en exécutant la requête qui représente le jeu d'enregistrements.
Fermer Ferme l'objet recordset et l' ODBC HSTMT associés.

Attributs de l'objet Recordset

CanAppend Renvoie différent de zéro si de nouveaux dossiers peuvent être ajoutés à l'objet recordset via la fonction membre AddNew.
CanBookmark Renvoie zéro si le jeu d'enregistrements prend en charge les signets.
CanRestart Renvoie zéro si Requery peut être qualifié de réexécuter la requête du jeu d'enregistrements.
CanScroll Renvoie zéro si vous pouvez faire défiler les enregistrements.
CanTransact Renvoie zéro si la source de données prend en charge les transactions.
CanUpdate Renvoie zéro si le jeu d'enregistrements peut être mis à jour (vous pouvez ajouter, mettre à jour ou supprimer des enregistrements).
GetODBCFieldCount Retourne le nombre de champs dans le jeu d'enregistrements.
GetRecordCount Retourne le nombre d'enregistrements dans le jeu d'enregistrements.
GetStatus Obtient le statut de l'objet recordset : l'index de l'enregistrement en cours et si un décompte final des dossiers a été obtenu.
GetTableName Obtient le nom de la table sur laquelle est basé le jeu d'enregistrements.
GetSQL Obtient la chaîne SQL utilisée pour sélectionner les enregistrements du jeu d'enregistrements.
IsOpen Renvoie zéro si ouvert a été appelé précédemment.
IsBOF Renvoie zéro si le jeu d'enregistrements a été positionné avant le premier enregistrement. Il n'y a aucun enregistrement en cours.
IsEOF Renvoie zéro si le jeu d'enregistrements a été placé après le dernier enregistrement. Il n'y a aucun enregistrement en cours.
IsDeleted Renvoie zéro si le jeu d'enregistrements est positionné sur un enregistrement supprimé.

Opérations de mise à jour de jeu d'enregistrements

AddNew Prépare pour ajouter un nouvel enregistrement. Appelez Update pour terminer l'ajout.
CancelUpdate Annule les mises à jour en attente en raison d'une opération de AddNew ou Edit.
Supprimer Supprime l'enregistrement actuel de l'objet recordset. Vous devez explicitement défilement à un autre enregistrement après la suppression.
Edit Se prépare pour les modifications apportées à l'enregistrement en cours. Appelez Update pour terminer le montage.
Mise à jour Termine une opération d'AddNew ou Edit en enregistrant les données nouvelles ou modifiées sur la source de données.

Opérations de Navigation de jeu d'enregistrements

GetBookmark Assigne la valeur de signet d'un document à l'objet de paramètre.
Déménagement Positionne le jeu d'enregistrements à un nombre spécifié d'enregistrements de l'enregistrement en cours dans les deux sens.
MoveFirst Positionne l'enregistrement en cours sur le premier enregistrement dans le jeu d'enregistrements. Tout d'abord tester IsBOF.
MoveLast Positionne l'enregistrement en cours sur le dernier enregistrement ou sur le dernier jeu de lignes. Tout d'abord tester IsEOF.
MoveNext Positionne l'enregistrement en cours sur l'enregistrement suivant ou sur l'ensemble de lignes suivant. Tout d'abord tester IsEOF.
MovePrev Positionne l'enregistrement en cours sur l'enregistrement précédent ou sur l'ensemble de lignes précédente. Tout d'abord tester IsBOF.
SetAbsolutePosition Positionne le jeu d'enregistrements dans le dossier correspondant au numéro du document spécifié.
SetBookmark Positionne le jeu d'enregistrements dans le dossier spécifié par le signet.

D'autres opérations de jeu d'enregistrements

Annuler Annule une opération asynchrone ou un processus à partir d'un deuxième thread.
FlushResultSet Retourne zéro s'il y a un autre résultat d'être récupérée, lorsque vous utilisez une requête prédéfinie.
GetFieldValue Retourne la valeur d'un champ dans un jeu d'enregistrements.
GetODBCFieldInfo Retourne des types spécifiques d'informations sur les champs dans un jeu d'enregistrements.
GetRowsetSize Renvoie le nombre d'enregistrements que vous souhaitez récupérer pendant une recherche unique.
GetRowsFetched Renvoie le nombre réel de lignes récupérée lors d'une extraction.
GetRowStatus Renvoie l'état de la ligne après une extraction.
IsFieldDirty Renvoie zéro si le champ spécifié dans l'enregistrement en cours a été modifié.
IsFieldNull Renvoie zéro si le champ spécifié dans l'enregistrement actif est Null (n'a aucune valeur).
IsFieldNullable Renvoie zéro si le champ spécifié dans l'enregistrement actif peut être défini à Null (n'ayant aucune valeur).
RefreshRowset Actualise les données et l'état de la ligne spécifiée (s).
Requery Exécute la requête du jeu d'enregistrements pour actualiser les enregistrements sélectionnés.
SetFieldDirty Marque le champ spécifié dans l'enregistrement en cours a changé.
SetFieldNull Définit la valeur du champ spécifié dans l'enregistrement actuel null (n'ayant aucune valeur).
SetLockingMode Définit le mode de verrouillage à blocage « pessimiste » ou « optimiste » de verrouillage (par défaut). Détermine la façon dont les enregistrements sont verrouillés pour les mises à jour.
SetParamNull Définit le paramètre spécifié à Null (n'ayant aucune valeur).
SetRowsetCursorPosition Positionne le curseur sur la ligne spécifiée dans l'ensemble de lignes.

Jeu d'enregistrements Overridables

Cocher Appelé pour examiner le code de retour d'une fonction API ODBC.
CheckRowsetError Appelé pour gérer les erreurs générées pendant l'enregistrement de l'extraction.
DoBulkFieldExchange Appelé échange de lignes en bloc des données de la source de données dans l'objet recordset. Matériel en vrac record field exchange (RFX en bloc).
DoFieldExchange Appelé à échanger des données (dans les deux directions) entre les données membres de champ de l'objet recordset et l'enregistrement correspondant sur la source de données. Implémente enregistre change de champ (RFX).
GetDefaultConnect Appelé pour obtenir la valeur par défaut chaîne de connexion.
GetDefaultSQL Appelé pour obtenir la chaîne SQL par défaut pour exécuter.
OnSetOptions Appelé pour définir les options de l'instruction ODBC spécifiée.
SetRowsetSize Spécifie le nombre d'enregistrements que vous souhaitez récupérer pendant une extraction.

Aperçu de CRecordset |  ; Membres de la classe base | Graphique de la hiérarchie

Index