GetRows-Methode (ADO)
Ruft mehrere Datensätze eines Recordset -Objekts in einem Array ab.
Syntax
array = recordset.GetRows(Rows, Start, Fields )
Rückgabewert
Gibt einen Variant- zurück, dessen Wert ein zweidimensionales Array ist.
Parameter
Zeilen
Wahlfrei. Ein GetRowsOptionEnum Wert, der die Anzahl der abzurufenden Datensätze angibt. Der Standardwert ist adGetRowsRest.
starten
Wahlfrei. Ein String Wert oder Variant, der die Textmarke für den Datensatz auswertet, aus dem der GetRows--Vorgang beginnen soll. Sie können auch einen BookmarkEnum Wert verwenden.
Felder
Wahlfrei. Eine Variant-, die einen einzelnen Feldnamen oder eine Ordnungsposition oder ein Array von Feldnamen oder Ordnungspositionszahlen 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. Der erste Tiefgestellt identifiziert das Feld und der zweite identifiziert die Datensatznummer. Das Array Variable wird automatisch auf die richtige Größe dimensioniert, wenn die GetRows Methode die Daten zurückgibt.
Wenn Sie keinen Wert für das Argument Rows angeben, ruft die GetRows-methode automatisch alle Datensätze im Recordset-Objekt ab. Wenn Sie mehr Datensätze anfordern, als verfügbar sind, 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 beginnen soll, indem Sie den Wert der Bookmark-Eigenschaft dieses Datensatzes im Argument Start übergeben.
Wenn Sie die Felder einschränken möchten, die der GetRows-aufruf zurückgibt, können Sie entweder einen einzelnen Feldnamen/eine einzelne Zahl oder ein Array von Feldnamen/Zahlen im argument Fields übergeben.
Nachdem Sie GetRows-aufgerufen haben, 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
Siehe auch
GetRows-Methode (Beispiel) (VB)
GetRows-Methode (Beispiel) (VC++)