CDaoRecordset-Klasse

Artikel
02/26/2013

Stellt eine Gruppe von Datensätzen, die aus einer Datenquelle ausgewählt werden.

class CDaoRecordset : public CObject

Mitglieder

Öffentliche Konstruktoren

Name	Beschreibung
CDaoRecordset::CDaoRecordset	Erstellt ein CDaoRecordset-Objekt.

Öffentliche Methoden

Name	Beschreibung
CDaoRecordset::AddNew	Bereitet sich für das Hinzufügen eines neuen Datensatzes vor.Aufruf Update, um der Addition abzuschließen.
CDaoRecordset::CanAppend	Gibt Wert ungleich 0 zurück, wenn neue Datensätze im Recordset über die AddNew-Memberfunktion hinzugefügt werden können.
CDaoRecordset::CanBookmark	Gibt Wert ungleich 0 zurück, wenn das Recordset Lesezeichen unterstützt.
CDaoRecordset::CancelUpdate	Bricht alle anstehenden Updates aufgrund eines Bearbeiten oder AddNew Vorgangs ab.
CDaoRecordset::CanRestart	Gibt Wert ungleich 0 zurück, wenn Fragen Sie erneut ab aufgerufen werden kann, um die Abfrage des Recordsets erneut auszuführen.
CDaoRecordset::CanScroll	Gibt Wert ungleich 0 (null) zurück, wenn Sie einen Bildlauf durch die Datensätze durchführen können.
CDaoRecordset::CanTransact	Gibt Wert ungleich 0 zurück, wenn die Datenquelle Transaktionen unterstützt.
CDaoRecordset::CanUpdate	Gibt Wert ungleich 0 zurück, wenn das Recordset aktualisiert werden kann (Sie können Datensätze hinzufügen, aktualisieren oder löschen).
CDaoRecordset::Close	Schließt das Recordset.
CDaoRecordset::Delete	Löscht den aktuellen Datensatz des Recordsets.Sie müssen zu einem anderen Datensatz nach dem Löschen explizit wechseln.
CDaoRecordset::DoFieldExchange	Aufgerufen für den Datenaustausch (in beide Richtungen) zwischen den Felddatenmembern des Recordsets und dem entsprechenden Datensatz in der Datenquelle.Werkzeug-DAO-Datensatzfeldaustausch (DFX).
CDaoRecordset::Edit	Bereitet sich für Änderungen am aktuellen Datensatz vor.Aufruf Update, um die Bearbeitung abzuschließen.
CDaoRecordset::FillCache	Füllt die gesamte oder einen Teil lokalen Cache für ein Recordset-Objekt aus, das Daten aus einer ODBC-Datenquelle enthält.
CDaoRecordset::Find	Sucht den ersten, nächsten, vorherigen oder letzten Speicherort einer bestimmten Zeichenfolge in einem Recordset vom Typ Dynaset, das die angegebenen Kriterien erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::FindFirst	Findet den ersten Satz in einem Recordset oder vom Typ Dynaset Momentaufnahme vom Typ, das die angegebenen Kriterien erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::FindLast	Findet den letzten Datensatz in einem Recordset oder vom Typ Dynaset Momentaufnahme vom Typ, das die angegebenen Kriterien erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::FindNext	Findet den nächsten Datensatz in einem Recordset oder vom Typ Dynaset Momentaufnahme vom Typ, das die angegebenen Kriterien erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::FindPrev	Findet den vorherigen Satz in einem Recordset oder vom Typ Dynaset Momentaufnahme vom Typ, das die angegebenen Kriterien erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::GetAbsolutePosition	Gibt die Datensatznummer des aktuellen Datensatzes eines Recordset-Objekts zurück.
CDaoRecordset::GetBookmark	Gibt einen Wert zurück, der das Lesezeichen auf einem Datensatz darstellt.
CDaoRecordset::GetCacheSize	Gibt einen Wert zurück, der die Anzahl von Datensätzen in einem Recordset vom Typ Dynaset angibt, das aus einer ODBC-Datenquelle enthält die lokal zwischengespeichert werden, Daten.
CDaoRecordset::GetCacheStart	Gibt einen Wert zurück, der das Lesezeichen des ersten Datensatzes im zwischengespeichert werden Recordset angibt.
CDaoRecordset::GetCurrentIndex	Gibt CString zurück, das den Namen des Indexes enthält, der auf indizierten, CDaoRecordset vom Typ Tabelle zuletzt verwendet wird.
CDaoRecordset::GetDateCreated	Gibt das Datum und die Uhrzeit zurück, die die zugrunde liegende Basistabelle ein Objekt erstellt wurde CDaoRecordset
CDaoRecordset::GetDateLastUpdated	Gibt das Datum und die Uhrzeit der letzten Änderung zurück, die am Entwurf einer zugrunde liegenden Basistabelle ein CDaoRecordset-Objekt vorgenommen wird.
CDaoRecordset::GetDefaultDBName	Gibt den Namen der standardmäßigen Datenquelle zurück.
CDaoRecordset::GetDefaultSQL	Aufgerufen, um die Zeichenfolge mit SQL abzurufen, um.
CDaoRecordset::GetEditMode	Gibt einen Wert zurück, der den Zustand der Bearbeitung für den aktuellen Datensatz angibt.
CDaoRecordset::GetFieldCount	Gibt einen Wert zurück, der die Anzahl von Feldern in einem Recordset darstellt.
CDaoRecordset::GetFieldInfo	Gibt bestimmte Arten von Informationen über die Felder im Recordset zurück.
CDaoRecordset::GetFieldValue	Gibt den Wert eines Felds in einem Recordset zurück.
CDaoRecordset::GetIndexCount	Ruft die Anzahl der Indizes in einer zugrunde liegenden Tabelle ein Recordset ab.
CDaoRecordset::GetIndexInfo	Gibt verschiedene Arten von Informationen über einen Index zurück.
CDaoRecordset::GetLastModifiedBookmark	Wird verwendet, um den hinzugefügten oder aktualisierten Datensatz zuletzt zu bestimmen.
CDaoRecordset::GetLockingMode	Gibt einen Wert zurück, der den Typ der Sperre angibt, die in Kraft während der Bearbeitung ist.
CDaoRecordset::GetName	Gibt CString zurück, das den Namen des Recordsets enthält.
CDaoRecordset::GetParamValue	Ruft den aktuellen Wert des angegebenen Parameters ab, der im zugrunde liegenden DAOParameter-Objekt gespeichert wird.
CDaoRecordset::GetPercentPosition	Gibt die Position des aktuellen Datensatzes als Prozentsatz der Gesamtanzahl der Datensätze zurück.
CDaoRecordset::GetRecordCount	Gibt die Anzahl der Datensätze zurück, die in einem Recordset-Objekt zugegriffen werden.
CDaoRecordset::GetSQL	Ruft die SQL-Zeichenfolge ab, die verwendet wird, um Datensätze für das Recordset auszuwählen.
CDaoRecordset::GetType	Aufgerufen, um den Typ eines Recordsets zu bestimmen: vom Typ Tabelle, vom Typ Dynaset oder vom Typ Momentaufnahme.
CDaoRecordset::GetValidationRule	Gibt CString zurück, das den Wert enthält, der Daten überprüft, während er in ein Feld eingegeben wird.
CDaoRecordset::GetValidationText	Ruft den Text ab, der angezeigt wird, wenn eine Validierungsregel nicht erfüllt ist.
CDaoRecordset::IsBOF	Gibt Wert ungleich 0 zurück, wenn das Recordset vor dem ersten Datensatz platziert wurde.Es gibt keinen aktuellen Datensatz.
CDaoRecordset::IsDeleted	Gibt Wert ungleich 0 zurück, wenn das Recordset auf gelöschten Datensatz platziert wird.
CDaoRecordset::IsEOF	Gibt Wert ungleich 0 zurück, wenn das Recordset hinter dem letzten Datensatz platziert wurde.Es gibt keinen aktuellen Datensatz.
CDaoRecordset::IsFieldDirty	Gibt Wert ungleich 0 zurück, wenn das angegebene Feld im aktuellen Datensatz geändert wurde.
CDaoRecordset::IsFieldNull	Gibt Wert ungleich 0 zurück, wenn das angegebene Feld im aktuellen Datensatz NULL ist (keinen Wert aufweist).
CDaoRecordset::IsFieldNullable	Gibt Wert ungleich 0 zurück, wenn das angegebene Feld im aktuellen Datensatz festgelegt werden kann, um ungültig zu machen (keinen Wert aufweist).
CDaoRecordset::IsOpen	Gibt Wert ungleich 0 zurück, wenn Geöffnet zuvor aufgerufen wurde.
CDaoRecordset::Move	Positioniert das Recordset auf eine angegebene Anzahl von Datensätzen im aktuellen Datensatz in beide Richtungen.
CDaoRecordset::MoveFirst	Positioniert den aktuellen Datensatz auf dem ersten Datensatz des Recordsets.
CDaoRecordset::MoveLast	Positioniert den aktuellen Datensatz auf dem letzten Datensatz des Recordsets.
CDaoRecordset::MoveNext	Positioniert den aktuellen Datensatz des nächsten Datensatz des Recordsets.
CDaoRecordset::MovePrev	Positioniert den aktuellen Datensatz des vorherigen Datensatz des Recordsets.
CDaoRecordset::Open	Erstellt ein neues Recordset aus einer Tabelle, einem Dynaset oder von einer Momentaufnahme.
CDaoRecordset::Requery	Führt die Abfrage des Recordsets erneut aus, um die ausgewählten Datensätze zu aktualisieren.
CDaoRecordset::Seek	Findet den Satz in einem Recordset indizierten vom Typ Tabellen-Objekt, das die angegebenen Kriterien für den aktuellen Index erfüllt und macht, das den aktuellen Datensatz aufzeichnen.
CDaoRecordset::SetAbsolutePosition	Legt die Datensatznummer des aktuellen Datensatzes eines Recordset-Objekts fest.
CDaoRecordset::SetBookmark	Positioniert das Recordset auf einem Datensatz, der das angegebene Lesezeichen enthält.
CDaoRecordset::SetCacheSize	Legt einen Wert fest, der die Anzahl von Datensätzen in einem Recordset vom Typ Dynaset angibt, das aus einer ODBC-Datenquelle enthält die lokal zwischengespeichert werden, Daten.
CDaoRecordset::SetCacheStart	Legt einen Wert fest, der das Lesezeichen des ersten Datensatzes im zwischengespeichert werden Recordset angibt.
CDaoRecordset::SetCurrentIndex	Aufgerufen, um einen Index in einem Recordset vom Typ Tabelle festzulegen.
CDaoRecordset::SetFieldDirty	Markiert das angegebene Feld im aktuellen Datensatz, wie geändert.
CDaoRecordset::SetFieldNull	Legt den Wert des angegebenen Felds im aktuellen Datensatz fest, um ungültig zu machen (keinen Wert aufweist).
CDaoRecordset::SetFieldValue	Legt den Wert eines Felds in einem Recordset.
CDaoRecordset::SetFieldValueNull	Legt den Wert eines Felds in einem Recordset fest, um ungültig zu machen.(keinen Wert aufweist).
CDaoRecordset::SetLockingMode	Legt einen Wert fest, der den Typ der Sperre angibt, die während der Bearbeitung zu bewerkstelligen.
CDaoRecordset::SetParamValue	Legt den aktuellen Wert des angegebenen Parameters fest, der im zugrunde liegenden DAOParameter-Objekt gespeichert wird
CDaoRecordset::SetParamValueNull	Legt den aktuellen Wert des angegebenen Parameters fest, um ungültig zu machen (keinen Wert aufweist).
CDaoRecordset::SetPercentPosition	Legt die Position des aktuellen Datensatzes zu einem Speicherort entspricht einem Prozentsatz der Gesamtanzahl der Datensätze in einem Recordset.
CDaoRecordset::Update	Schließt einen AddNew oder Edit Vorgang durch Speichern der neuen oder geänderten Daten in der Datenquelle.

Öffentliche Datenmember

Name	Beschreibung
CDaoRecordset::m_bCheckCacheForDirtyFields	Enthält ein Flag, das angibt, ob Felder automatisch markiert werden, wie geändert.
CDaoRecordset::m_nFields	Enthält die Anzahl der Felddatenmember in der Recordset-Klasse und die Anzahl der Spalten ausgewählt durch das Recordset aus der Datenquelle.
CDaoRecordset::m_nParams	Enthält die Anzahl der Parameterdatenmember in der Recordset-Klasse - die Anzahl von Parametern, die mit der Abfrage des Recordsets übergeben werden
CDaoRecordset::m_pDAORecordset	Ein Zeiger auf die zugrunde liegenden DAO-Schnittstelle das Recordset-Objekt.
CDaoRecordset::m_pDatabase	Quelldatenbank für dieses Resultset.Enthält einen Zeiger auf einen CDaoDatabase-Objekt.
CDaoRecordset::m_strFilter	Enthält eine Zeichenfolge, die verwendet wird, um eine Anweisung SQL WHERE zu erstellen.
CDaoRecordset::m_strSort	Enthält eine Zeichenfolge, die verwendet wird, um eine Anweisung SQL ORDER BY zu erstellen.

Hinweise

Bei diesen als "Recordsets," sind CDaoRecordset-Objekte in den folgenden drei Formen verfügbar:

Recordset vom Typ Tabellen stellen eine Basistabelle dar, die Sie verwenden können, um Datensätze aus einer einzelnen Datenbanktabelle zu überprüfen, hinzuzufügen, zu ändern oder zu löschen.
Recordsets vom Typ Dynaset sind das Ergebnis einer Abfrage, die aktualisierbare Datensätze haben kann.Diese Recordsets sind eine Gruppe von Datensätzen, die Sie verwenden können, um Datensätze aus einer Tabelle oder Tabellen der zugrunde liegenden Datenbank sicherzustellen, hinzuzufügen, zu ändern oder zu löschen.Recordsets vom Typ Dynaset können Felder aus einer oder mehreren Tabellen in einer Datenbank enthalten.
Recordsets vom Typ Momentaufnahme sind eine statische Kopie Gruppe von Datensätzen, die Sie verwenden können, um Daten zu suchen oder Berichte zu generieren.Diese Felder können Recordsets, aus einer oder mehreren Tabellen in einer Datenbank enthalten jedoch können nicht aktualisiert werden.

Jedes Formular des Recordsets stellt korrigierten Gruppe von Datensätzen dar, wenn das Recordset geöffnet ist.Wenn Sie zu einem Datensatz in einem Recordset vom Typ Tabelle oder in einem Recordset vom Typ Dynaset wechseln, gibt es die Änderungen, die am Datensatz vorgenommen werden, nachdem das Recordset, entweder durch andere Benutzer oder von anderen Recordsets in der Anwendung geöffnet wird.(Ein Recordset vom Typ Momentaufnahme kann nicht aktualisiert werden.) Sie können CDaoRecordset direkt verwenden oder eine anwendungsspezifische Recordset-Klasse von CDaoRecordset berechnen.Sie können anschließend folgende Aktionen durchführen:

Bildlauf durch die Datensätze.
Legen Sie einen Index fest und suchen Sie schnell nach Datensätzen mit Suche (nur Recordset vom Typ Tabellen).
Suchen Sie Datensätze auf Grundlage einen Zeichenfolgenvergleich: "<", "<=", "=", ">=" oder ">" (und Recordsets vom Typ Dynaset vom Typ Momentaufnahme).
Aktualisieren Sie die Datensätze und geben Sie ein Sperrverhalten an (außer Recordsets vom Typ Momentaufnahme).
Filtern Sie das Recordset, um einzuschränken, das Datensätze es von denen auswählen, die in der Datenquelle verfügbar sind.
Sortieren das Recordset.
Parametrisieren Sie das Recordset, um seine Auswahl mit den Informationen anzupassen, die erst zur Laufzeit bekannt sind.

Klassifizieren Sie CDaoRecordset stellt eine Schnittstelle, die zu der der - Klasse CRecordset ähnelt.Der Hauptunterschied liegt darin, dass Klasse CDaoRecordset auf Daten über ein Datenzugriffsobjekt (DAO) anhand OLE zugreift.Klasse CRecordset greift auf das DBMS von Open Database Connectivity (ODBC) und einen ODBC-Treiber für dieses DBMS zu.

Hinweis
Die DAO-Datenbankklassen sind von den MFC-Datenbankklassen auf Grundlage Open Database Connectivity (ODBC) unterschiedlich.Alle DAO-Datenbankklassen-Namen haben das Präfix "CDao".Sie können auf ODBC-Datenquellen mit den DAO-Klassen noch zugreifen; DAO-Klassen bieten im Allgemeinen überlegene Funktionen, da sie an Microsoft Jet-Datenbankmodul spezifisch sind.

Sie können entweder CDaoRecordset direkt verwenden oder eine Klasse von CDaoRecordset berechnen.So fügen Sie eine Recordset-Klasse in jedem Fall verwenden, eine Datenbank öffnen und ein Recordset-Objekt, den Konstruktor übergibt ein Zeiger auf dem CDaoDatabase-Objekt erstellen.Sie können ein CDaoRecordset-Objekt auch erstellen und lassen MFC ein temporäres Objekt CDaoDatabase für Sie erstellen.Rufen Sie dann die Geöffnet-Memberfunktion des Recordsets auf und angeben, ob das Objekt ein Recordset vom Typ Tabelle, ein Recordset vom Typ Dynaset oder ein Recordset vom Typ Momentaufnahme ist.Das Aufrufen von Open wählt Daten aus der Datenbank aus und ruft den ersten Datensatz ab.

Verwenden Sie die Memberfunktionen und Datenmember Objekts zum Bildlauf durch die Datensätze und lassen Sie an diese ausgeführt werden.Die verfügbaren Vorgänge hängen davon ab, ob das Objekt ein Recordset vom Typ Tabelle, ein Recordset vom Typ Dynaset oder ein Recordset vom Typ Momentaufnahme ist und ob es aktualisierbar oder schreibgeschützt ist - dies von der Funktion der Datenbank oder der Datenquelle der Open Database Connectivity (ODBC) abhängt.So Datensätze aktualisieren, die möglicherweise geändert werden oder hinzugefügt, da der Open Aufruf, die Fragen Sie erneut ab-Memberfunktion des Objekts aufrufen.Rufen Sie die Memberfunktion des Objekts auf Close und das Objekt zerstört, wenn Sie mit ihr beenden.

CDaoRecordset verwendet DAO-Datensatzfeldaustausch (DFX) zum Lesen und Aktualisieren von Datensatzfeldern durch typsichere C++-Member aus dem CDaoRecordset oder von CDaoRecordset zur Unterstützung von abgeleitete Klasse.Sie können dynamische Binden von Spalten in einer Datenbank auch implementieren, ohne den DFX-Mechanismus mithilfe GetFieldValue und SetFieldValue zu verwenden.

Weitere Informationen finden Sie im Thema "Recordset-Objekt" in der DAO-Hilfe.