RecordCount-Eigenschaft (ADO)

Gilt für: Access 2013, Office 2013

Gibt die Anzahl von Datensätzen in einem Recordset-Objekt an.

Rückgabewert

Gibt einen Long-Wert zurück, der die Anzahl von Datensätzen im Recordset-Objekt angibt.

Hinweise

Ermitteln Sie mit der RecordCount -Eigenschaft die Anzahl von Datensätzen in einem Recordset -Objekt. Die Eigenschaft gibt -1 zurück, wenn ADO die Anzahl von Datensätzen nicht bestimmen kann oder wenn der Anbieter- oder Cursortyp RecordCount nicht unterstützt. Das Lesen der RecordCount -Eigenschaft für ein geschlossenes Recordset -Objekt verursacht einen Fehler.

Wenn das Recordset-Objekt ungefähre Positionierungen oder Lesezeichen unterstützt , d. h. Supports (adApproxPosition) bzw . Supports (adBookmark)true zurückgeben, ist dieser Wert die genaue Anzahl von Datensätzen im Recordset, unabhängig davon, ob er vollständig aufgefüllt wurde. Wenn das Recordset-Objekt keine ungefähre Positionierung unterstützt, kann diese Eigenschaft eine erhebliche Belastung für Ressourcen darstellen, da alle Datensätze abgerufen und gezählt werden müssen, um einen genauen RecordCount-Wert zurückzugeben.

Der Cursortyp des Recordset -Objekts beeinflusst die Anzahl von Datensätzen, die ermittelt werden können. Die RecordCount-Eigenschaft gibt -1 für einen Vorwärtscursor zurück; die tatsächliche Anzahl für einen statischen oder einen Keyset-Cursor; und je nach Datenquelle entweder -1 oder die tatsächliche Anzahl für einen dynamischen Cursor.