CDaoRecordset::GetRecordCount
Rufen Sie die Memberfunktion auf, um zu ermitteln, auf wie viele Datensätzen in einem Recordset zugegriffen wurde.
long GetRecordCount( );
Rückgabewert
Gibt die Anzahl der Datensätze zurück, die in einem Recordset-Objekt zugegriffen werden.
Hinweise
GetRecordCount gibt nicht an, wie viele Datensätze in einem Recordset oder vom Typ Dynaset vom Typ Momentaufnahme enthalten sind, bis auf alle Datensätze zugegriffen wurde.Dieser Memberfunktionsaufruf akzeptiert möglicherweise einige Zeit, um abzuschließen.
Sobald auf den letzten Datensatz zugegriffen wurde, ist der Rückgabewert die Gesamtzahl der wiederhergestellten Datensätze im Recordset an.Um den zugegriffen werden letzten Datensatz zu erzwingen, rufen Sie die MoveLast oder FindLast-Memberfunktion für das Recordset auf.Sie können eine SQL-Anzahl auch verwenden, um die ungefähre Anzahl von Datensätzen zu bestimmen, die die Abfrage zurückgibt.
Wie die Anwendung Datensätzen in einem Recordset vom Typ Dynaset gelöscht, der Rückgabewert von GetRecordCount nimmt ab.Allerdings werden die Datensätze, die von anderen Benutzern gelöscht werden, nicht von GetRecordCount wiedergegeben, bis der aktuelle Datensatz zu gelöschten Datensatz positioniert ist.Wenn Sie eine Transaktion, die die Anzahl der Datensätze betroffen und zurücksetzen später die Transaktion ausführen, spiegelt GetRecordCount nicht die tatsächliche Anzahl der verbleibenden Datensätzen.
Der Wert von GetRecordCount aus einem Recordset vom Typ Momentaufnahme wird nicht von Änderungen in den zugrunde liegenden Tabellen auswirkt.
Der Wert von GetRecordCount aus einem Recordset vom Typ Tabelle spiegelt die ungefähre Anzahl von Datensätzen in der Tabelle und wird sofort auswirkt, während Tabellendatensätze hinzugefügt und gelöscht werden.
Ein Recordset ohne Datensätze gibt einen Wert von 0 zurück.Beim Arbeiten mit umschlossenen Tabellen oder ODBC-Datenbanken, gibt GetRecordCount immer - 1. zurück.Das Aufrufen der Requery-Memberfunktion auf einem Recordset setzt den Wert von GetRecordCount zurück, als ob die Abfrage wieder-ausgeführt wurden.
Weitere Informationen finden Sie im Thema "RecordCount-Eigenschaft" in der DAO-Hilfe.
Anforderungen
Header: afxdao.h