GetRows-Methode (ADO)

  • Artikel

Ruft mehrere Datensätze eines Recordset-Objekts in ein Array ab.

Syntax

  
array = recordset.GetRows(Rows, Start, Fields )

Rückgabewert

Gibt eine Variante mit einem zweidimensionalen Array als Wert zurück.

Parameter

Zeilen
Optional. Ein GetRowsOptionEnum-Wert, der die Anzahl der Datensätze angibt, die abgerufen werden sollen. Der Standard ist adGetRowsRest.

Starten
Optional. Ein Zeichenfolgenwert oder eine Variante, der bzw. die in das Lesezeichen für den Datensatz ausgewertet wird, von dem der GetRows-Vorgang beginnen sollte. Sie können auch einen BookmarkEnum-Wert verwenden.

Fields
Optional. Eine Variante, die einen einzelnen Feldnamen oder eine Ordinalposition oder ein Array von Feldnamen oder Ordinalpositionsnummern darstellt. ADO gibt nur die Daten in diesen Feldern zurück.

Bemerkungen

Verwenden Sie die GetRows-Methode, um Datensätze aus einem Recordset in ein zweidimensionales Array zu kopieren. Das erste Subskript identifiziert das Feld und das zweite identifiziert die Datensatznummer. Die Arrayvariable wird automatisch auf die richtige Größe dimensioniert, wenn die GetRows-Methode die Daten zurückgibt.

Wenn Sie keinen Wert für das Rows-Argument angeben, ruft die GetRows-Methode automatisch alle Datensätze im Recordset-Objekt ab. Wenn Sie mehr Datensätze anfordern als verfügbar, gibt GetRows nur die Anzahl der verfügbaren Datensätze zurück.

Wenn das Recordset-Objekt Lesezeichen unterstützt, können Sie angeben, an welchem Datensatz die GetRows-Methode mit dem Abrufen von Daten beginnen soll, indem Sie den Wert der Bookmark-Eigenschaft dieses Datensatzes im Start-Argument übergeben.

Wenn Sie die Felder einschränken möchten, die der GetRows-Aufruf zurückgibt, können Sie entweder einen einzelnen Feldnamen/eine Zahl oder ein Array von Feldnamen/Zahlen im Fields-Argument übergeben.

Nachdem Sie GetRows aufrufen, wird der nächste ungelesene Datensatz zum aktuellen Datensatz, oder die EOF-Eigenschaft wird auf True festgelegt, wenn keine weiteren Datensätze vorhanden sind.

Gilt für

Recordset-Objekt (ADO)

Weitere Informationen

GetRows-Methode – Beispiel (VB)
GetRows-Methode – Beispiel (VC++)