RecordCount-Eigenschaft (ADO)

  • Artikel

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

Rückgabewert

Gibt einen Long-Wert zurück, der angibt, wie viele Datensätze im Recordset enthalten sind.

Bemerkungen

Verwenden Sie die RecordCount-Eigenschaft , 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 RecordCount nicht unterstützt. Durch das Lesen der RecordCount-Eigenschaft in einem geschlossenen Recordset wird ein Fehler verursacht.

Textmarken oder ungefähre Positionierung

Wenn das Recordset-Objekt entweder Textmarken oder die 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 jedoch Textmarken und die ungefähre Positionierung nicht unterstützt, kann der Zugriff auf diese Eigenschaft eine erhebliche Belastung für Ressourcen sein. Der Ausgleich erfolgt, da alle Datensätze abgerufen und gezählt werden müssen, um einen genauen RecordCount-Wert zurückzugeben.

  • adBookmark bezieht sich auf Textmarken.
  • adApproxPosition bezieht sich auf die ungefähre Positionierung.

Hinweis

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 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 RecordCount-Eigenschaft gibt -1 für einen Vorwärtscursor zurück; die tatsächliche Anzahl für einen statischen oder Keyset-Cursor; und entweder -1 oder die tatsächliche Anzahl für einen dynamischen Cursor, je nach Datenquelle.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

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