Classe de CDaoRecordset

Article
03/26/2013

Représente un ensemble d'enregistrements sélectionnés à partir d'une source de données.

class CDaoRecordset : public CObject

Membres

Constructeurs publics

Nom	Description
CDaoRecordset::CDaoRecordset	Construit un objet CDaoRecordset.

Méthodes publiques

Nom	Description
CDaoRecordset::AddNew	Se prépare à ajouter un nouvel enregistrement.Appel mise à jour pour effectuer l'addition.
CDaoRecordset::CanAppend	Retourne une valeur différente de zéro si les nouveaux enregistrements peuvent être ajoutés au recordset via la fonction membre d' AddNew .
CDaoRecordset::CanBookmark	Retourne une valeur différente de zéro si le recordset prend en charge des signets.
CDaoRecordset::CancelUpdate	Annule toutes les mises à jour en attente en raison de modification ou d'une opération d' AddNew .
CDaoRecordset::CanRestart	Retourne une valeur différente de zéro si Actualiser peut être appelé pour exécuter la requête du recordset de nouveau.
CDaoRecordset::CanScroll	Retourne une valeur différente de zéro si vous pouvez parcourir les enregistrements.
CDaoRecordset::CanTransact	Retourne une valeur différente de zéro si la source de données prend en charge les transactions.
CDaoRecordset::CanUpdate	Retourne une valeur différente de zéro si le recordset peut être mis à jour (vous pouvez ajouter, mettre à jour, ou supprimer des enregistrements).
CDaoRecordset::Close	Ferme le recordset.
CDaoRecordset::Delete	Supprime l'enregistrement actif du recordset.Vous devez explicitement le défilement à un autre enregistrement après la suppression.
CDaoRecordset::DoFieldExchange	Appelé pour échanger des données (dans les deux sens) entre les membres de données de type champ de recordset et l'enregistrement correspondant de la source de données.Processus DFX d'outils (DFX).
CDaoRecordset::Edit	Se prépare à des modifications apportées à l'enregistrement courant.Appel Mettre à jour pour terminer la modification.
CDaoRecordset::FillCache	Remplit tout l'ou partie cache local d'un objet recordset qui contient des données d'une source de données ODBC.
CDaoRecordset::Find	Recherche le premier, ensuite, précédent, ou dernier emplacement d'une chaîne particulière dans un recordset de type feuille de réponse dynamique qui répond aux critères spécifiés et le fait qui signalent l'enregistrement courant.
CDaoRecordset::FindFirst	Recherche le premier enregistrement dans un recordset de type feuille de réponse dynamique ou de type instantané qui répond aux critères spécifiés et le fait qui signalent l'enregistrement courant.
CDaoRecordset::FindLast	Recherche le dernier enregistrement dans un recordset de type feuille de réponse dynamique ou de type instantané qui répond aux critères spécifiés et le fait qui signalent l'enregistrement courant.
CDaoRecordset::FindNext	Recherche le premier enregistrement dans un recordset de type feuille de réponse dynamique ou de type instantané qui répond aux critères spécifiés et le fait qui signalent l'enregistrement courant.
CDaoRecordset::FindPrev	Localise l'enregistrement précédent dans un recordset de type feuille de réponse dynamique ou de type instantané qui répond aux critères spécifiés et le fait qui signalent l'enregistrement courant.
CDaoRecordset::GetAbsolutePosition	Retourne le nombre d'enregistrement de l'enregistrement actuel d'un objet recordset.
CDaoRecordset::GetBookmark	Retourne une valeur qui représente le signet sur un enregistrement.
CDaoRecordset::GetCacheSize	Retourne une valeur qui spécifie le nombre d'enregistrements dans un recordset de type feuille de réponse dynamique contenant des données à mettre en cache localement d'une source de données ODBC.
CDaoRecordset::GetCacheStart	Retourne une valeur qui spécifie le signet au premier enregistrement du recordset à mettre en cache.
CDaoRecordset::GetCurrentIndex	Retourne CString contenant le nom de l'index derniers fichiers utilisés sur CDaoRecordsetindexé et de type table.
CDaoRecordset::GetDateCreated	Retourne la date et l'heure de la table de base sous-jacente à un objet d' CDaoRecordset a été créée
CDaoRecordset::GetDateLastUpdated	Retourne la date et l'heure de la modification apportée la plus récente à la conception d'une table de base sous-jacente à un objet d' CDaoRecordset .
CDaoRecordset::GetDefaultDBName	Retourne le nom de la source de données par défaut.
CDaoRecordset::GetDefaultSQL	Appelé pour obtenir la chaîne SQL par défaut de l'exécution.
CDaoRecordset::GetEditMode	Retourne une valeur qui indique l'état de la modification de l'enregistrement actuel.
CDaoRecordset::GetFieldCount	Retourne une valeur qui représente le nombre de champs d'un recordset.
CDaoRecordset::GetFieldInfo	Retourne les types spécifiques d'informations sur les champs du recordset.
CDaoRecordset::GetFieldValue	Retourne la valeur d'un champ d'un recordset.
CDaoRecordset::GetIndexCount	Récupère le nombre d'index dans une table sous-jacente à un recordset.
CDaoRecordset::GetIndexInfo	Retourne différents types d'informations à propos d'un index.
CDaoRecordset::GetLastModifiedBookmark	Utilisé pour déterminer l'enregistrement récemment ajouté ou mis à jour.
CDaoRecordset::GetLockingMode	Retourne une valeur qui indique le type de verrou qui est appliquée lors de la modification.
CDaoRecordset::GetName	Retourne CString contenant le nom du recordset.
CDaoRecordset::GetParamValue	Extrait la valeur actuelle du paramètre spécifié stocké dans l'objet sous-jacent de DAOParameter.
CDaoRecordset::GetPercentPosition	Retourne la position de l'enregistrement en cours comme un pourcentage du nombre total des enregistrements.
CDaoRecordset::GetRecordCount	Retourne le nombre d'enregistrements accessibles dans un objet recordset.
CDaoRecordset::GetSQL	Obtient la chaîne SQL utilisée pour sélectionner des enregistrements du recordset.
CDaoRecordset::GetType	Appelé pour déterminer le type d'un recordset : de type table, de type feuille de réponse dynamique, ou de type instantané.
CDaoRecordset::GetValidationRule	Retourne CString contenant la valeur qui valide les données à mesure qu'elle est écrite dans un champ.
CDaoRecordset::GetValidationText	Extrait le texte affiché lorsqu'une règle de validation n'est pas satisfaite.
CDaoRecordset::IsBOF	Retourne une valeur différente de zéro si le recordset a été positionné avant le premier enregistrement.Il n'existe aucun enregistrement courant.
CDaoRecordset::IsDeleted	Retourne une valeur différente de zéro si le recordset est positionné sur un enregistrement supprimé.
CDaoRecordset::IsEOF	Retourne une valeur différente de zéro si le recordset a été positionnée après le dernier enregistrement.Il n'existe aucun enregistrement courant.
CDaoRecordset::IsFieldDirty	Retourne une valeur différente de zéro si le champ spécifié dans l'enregistrement en cours a été modifié.
CDaoRecordset::IsFieldNull	Retourne une valeur différente de zéro si le champ spécifié dans l'enregistrement en cours est null (n'ayant pas de valeur).
CDaoRecordset::IsFieldNullable	Retourne une valeur différente de zéro si le champ spécifié dans l'enregistrement en cours peut avoir la valeur Null (n'ayant pas de valeur).
CDaoRecordset::IsOpen	Retourne une valeur différente de zéro si Ouvrez a été appelé précédemment.
CDaoRecordset::Move	Positionne le recordset en nombre d'enregistrements spécifié de l'enregistrement en cours dans l'un ou l'autre direction.
CDaoRecordset::MoveFirst	Positionne l'enregistrement actif sur le premier enregistrement du recordset.
CDaoRecordset::MoveLast	Positionne l'enregistrement actif sur le dernier enregistrement du recordset.
CDaoRecordset::MoveNext	Positionne l'enregistrement en cours sur l'enregistrement du recordset.
CDaoRecordset::MovePrev	Positionne l'enregistrement en cours sur l'enregistrement précédent dans le recordset.
CDaoRecordset::Open	Crée un recordset d'une table, d'une feuille de réponse dynamique, ou d'un instantané.
CDaoRecordset::Requery	Exécute la requête du recordset de nouveau pour actualiser les enregistrements sélectionnés.
CDaoRecordset::Seek	Localise l'enregistrement dans un objet indexé de recordset de type table qui répond aux critères spécifiés pour l'index actuel et le fait qui signalent l'enregistrement courant.
CDaoRecordset::SetAbsolutePosition	Définit le nombre d'enregistrement de l'enregistrement actuel d'un objet recordset.
CDaoRecordset::SetBookmark	Positionne le recordset sur un enregistrement contenant le signet spécifié.
CDaoRecordset::SetCacheSize	Définit une valeur qui spécifie le nombre d'enregistrements dans un recordset de type feuille de réponse dynamique contenant des données à mettre en cache localement d'une source de données ODBC.
CDaoRecordset::SetCacheStart	Définit une valeur spécifiant le signet au premier enregistrement du recordset à mettre en cache.
CDaoRecordset::SetCurrentIndex	Appelé pour définir un index sur un recordset de type table.
CDaoRecordset::SetFieldDirty	Marque le champ spécifié dans l'enregistrement en cours comme changé.
CDaoRecordset::SetFieldNull	Définit la valeur du champ spécifié dans l'enregistrement actif à Null (n'ayant pas de valeur).
CDaoRecordset::SetFieldValue	Définit la valeur d'un champ d'un recordset.
CDaoRecordset::SetFieldValueNull	Définit la valeur d'un champ d'un recordset avec la valeur Null.(n'ayant pas de valeur).
CDaoRecordset::SetLockingMode	Définit une valeur indiquant le type de verrouillage pour mettre en œuvre pendant la modification.
CDaoRecordset::SetParamValue	Définit la valeur actuelle du paramètre spécifié stocké dans l'objet sous-jacent de DAOParameter
CDaoRecordset::SetParamValueNull	Définit la valeur actuelle du paramètre spécifié avec la valeur Null (n'ayant pas de valeur).
CDaoRecordset::SetPercentPosition	Définit la position de l'enregistrement actif à un emplacement correspondant à un pourcentage du nombre total des enregistrements dans un recordset.
CDaoRecordset::Update	Termine une opération d' AddNew ou de Modifier en enregistrant les données nouvelles ou modifiées dans la source de données.

Données membres publiques

Nom	Description
CDaoRecordset::m_bCheckCacheForDirtyFields	Contient une balise qui indique si les champs sont automatiquement marquées comme changés.
CDaoRecordset::m_nFields	Contient le nombre de membres de données de type champ dans la classe de recordset et le nombre de colonnes sélectionnées par le recordset de la source de données.
CDaoRecordset::m_nParams	Contient le nombre de membres de données de type paramètre dans la classe de recordset (le nombre de paramètres passés à la requête du recordset
CDaoRecordset::m_pDAORecordset	Pointeur vers l'interface DAO sous-jacent à l'objet recordset.
CDaoRecordset::m_pDatabase	Base de données source de ce jeu de résultats.Contient un pointeur vers un objet de CDaoDatabase .
CDaoRecordset::m_strFilter	Contient une chaîne utilisée pour construire une instruction SQL WHERE .
CDaoRecordset::m_strSort	Contient une chaîne utilisée pour construire une instruction SQL ORDER BY .

Notes

Appelés « recordsets, » les objets d' CDaoRecordset sont disponibles dans les trois formes suivantes :

Les recordsets de type table représentent une table de base que vous pouvez utiliser pour examiner, ajouter, modifier, ou supprimer des enregistrements d'une table de base de données unique.
Les recordsets de type feuille de réponse dynamique sont le résultat d'une requête qui peut avoir des enregistrements modifiable.Les recordsets sont un ensemble d'enregistrements que vous pouvez utiliser pour examiner, ajouter, modifier, ou supprimer des enregistrements d'une table ou des tables de base de données sous-jacents.Les recordsets de type feuille de réponse dynamique peuvent contenir des champs d'une ou de plusieurs tables dans une base de données.
Les recordsets de type instantané sont une copie statique d'un ensemble d'enregistrements que vous pouvez utiliser pour rechercher des données ou créer des rapports.Les recordsets peuvent contenir des champs d'une ou de plusieurs tables dans une base de données mais ne peuvent pas être mis à jour.

Chaque forme de recordset représente un ensemble d'enregistrements résolus au moment où le recordset est ouvert.Lorsque vous accédez à un enregistrement dans un recordset de type table ou un recordset de type feuille de réponse dynamique, elle reflète les modifications apportées à l'enregistrement après que le recordset est ouvert, par d'autres utilisateurs ou par d'autres recordsets dans votre application.(Le recordset de type instantané d'Un ne peut pas être mis à jour.) Vous pouvez utiliser CDaoRecordset directement ou dériver une classe de recordset spécifique à l'application d' CDaoRecordset.Ensuite, vous pouvez :

Parcourir les enregistrements.
Définissez un index et trouver rapidement des enregistrements à l'aide de accès (recordsets de type table uniquement).
Recherchez les enregistrements en fonction d'une comparaison de chaînes : « < », « <= », « = », « >= », ou « > » (recordsets de type feuille de réponse dynamique et de type instantané).
Mettre à jour des enregistrements et spécifiez à jour le mode de verrouillage (sauf les recordsets de type instantané).
Filtrez le recordset pour limiter les enregistrements il choisit parmi celles disponibles dans la source de données.
Trier le recordset.
Paramétrer le recordset pour personnaliser la sélection des informations inconnues qu'au moment de l'exécution.

Classez le fournit d' CDaoRecordset une interface semblable à celle de la classe CRecordset.La principale différence est ces données d'accès d' CDaoRecordset de classe via objet d'accès aux données (DAO) avec OLE.Classez les accès d' CRecordset le système de gestion de base de données via (Open Database Connectivity) et un pilote ODBC pour ce système de gestion de base de données.

[!REMARQUE]

Les classes de bases de données DAO sont séparées des classes de base de données MFC basée sur (Open Database Connectivity).Tous les noms de classes de bases de données DAO ont le préfixe « CDao ».Vous pouvez encore accéder aux sources de données ODBC avec les classes DAO ; les classes DAO offrent généralement des fonctionnalités améliorées car elles sont spécifiques au moteur de base de données Microsoft Jet.

Vous pouvez utiliser CDaoRecordset directement ou dériver une classe d' CDaoRecordset.Pour utiliser une classe de recordset dans les deux cas, ouvrir une base de données et construire un objet recordset, en passant le constructeur un pointeur vers l'objet d' CDaoDatabase .Vous pouvez également construire un objet d' CDaoRecordset et laissez MFC créer un objet temporaire d' CDaoDatabase pour vous.Appelez la fonction membre d' Ouvrez du recordset, indiquant si l'objet est un recordset de type table, un recordset de type feuille de réponse dynamique, ou un recordset de type instantané.Appeler Ouvrir sélectionne des données de la base de données et extrait le premier enregistrement.

Utilisez les fonctions membres et les données membres de l'objet au défilement des enregistrements et traitez- les.Les opérations disponibles dépendent de si l'objet est un recordset de type table, un recordset de type feuille de réponse dynamique, ou un recordset de type instantané, et s'il est modifiables ou en lecture seule (cela dépend de la capacité de la base de données ou de la source de données ODBC (Open Database Connectivity).Pour actualiser les enregistrements qui ont peut-être été modifiés ou ajoutés comme l'appel de Ouvrir , appelez la fonction membre d' Actualiser de l'objet.Appelez la fonction membre de Fermer de l'objet et détruisez l'objet lorsque vous avez terminé avec elle.

Processus DFX d' utilisation d'CDaoRecordset (DFX) pour prendre en charge la lecture et mettre à jour les champs d'enregistrement par les membres de type sécurisé C++ de votre CDaoRecordset ou d' CDaoRecordsetclasse dérivée.Vous pouvez également implémenter la liaison dynamique des colonnes dans une base de données sans utiliser le mécanisme DFX à l'aide de GetFieldValue et SetFieldValue.

Pour des informations connexes, consultez la rubrique « objet recordset » dans l'aide de DAO.