Freigeben über


RecordCount-Eigenschaft (ADO)

Gibt die Anzahl der Datensätze in einem Recordset- -Objekt an.

Rückgabewert

Gibt einen wert vom Typ Long zurück, der die Anzahl der Datensätze im Recordset-angibt.

Bemerkungen

Verwenden Sie die eigenschaft RecordCount, um herauszufinden, wie viele Datensätze in einem Recordset--Objekt vorhanden sind. Die Eigenschaft gibt -1 zurück, wenn ADO die Anzahl der Datensätze nicht ermitteln kann oder wenn der Anbieter oder Cursortyp RecordCountnicht unterstützt. Das Lesen der RecordCount-Eigenschaft für ein geschlossenes Recordset- verursacht einen Fehler.

Lesezeichen oder ungefähre Positionierung

Wenn das Recordset-Objekt entweder Lesezeichen oder ungefähre Positionierung unterstützt, gibt diese Eigenschaft die genaue Anzahl von Datensätzen im Recordset zurück. Diese Eigenschaft gibt die genaue Zahl zurück, unabhängig davon, ob das Recordset vollständig ausgefüllt wurde.

Wenn das Recordset-Objekt dagegen nicht Lesezeichen oder ungefähre Positionierung unterstützen, kann der Zugriff auf diese Eigenschaft einen erheblichen Ressourcenverbrauch bedeuten. Der Abfluss tritt auf, da alle Datensätze abgerufen und gezählt werden müssen, um einen genauen RecordCount-Wert zurückzugeben.

  • adBookmark im Zusammenhang mit Lesezeichen.
  • adApproxPosition bezieht sich auf die ungefähre Positionierung.

Anmerkung

In ADO-Versionen 2.8 und früher ruft der SQLOLEDB-Anbieter alle Datensätze ab, wenn ein serverseitiger Cursor verwendet wird, obwohl er True- für beide Supports (adApproxPosition) und Supports (adBookmark)zurückgibt.

Der Cursortyp des Recordset-Objekts wirkt sich darauf aus, ob die Anzahl der Datensätze bestimmt werden kann. Die eigenschaft RecordCount gibt -1 für einen Vorwärtscursor zurück; die tatsächliche Anzahl für einen statischen oder Keysetcursor; und entweder -1 oder die tatsächliche Anzahl für einen dynamischen Cursor, abhängig von der Datenquelle.

Gilt für

Recordset-Objekt (ADO)

Siehe auch

Filter- und RecordCount-Eigenschaft (Vb-Beispiel)
Filter- und RecordCount-Eigenschaft (Beispiel) (VC++)
AbsolutePosition-Eigenschaft (ADO)
PageCount-Eigenschaft (ADO)