Arbeiten mit Recordsets

Artikel
04/04/2023

Gilt für: Access 2013, Office 2013

Das Recordset-Objekt weist integrierte Features auf, mit denen Sie die Reihenfolge der Daten im Resultset ändern, nach einem bestimmten Datensatz basierend auf eingegebenen Kriterien suchen und sogar diese Suchvorgänge mithilfe von Indizes optimieren können. Die Verfügbarkeit dieser Features hängt vom Anbieter und in manchen Fällen – wie z. B. bei der Index-Eigenschaft – von der Struktur der Datenquelle selbst ab.

Anordnen von Daten

Das Angeben einer ORDER BY-Klausel im SQL-Befehl, mit dem Ergebnisse zurückgegeben werden, ist häufig die effizienteste Methode, um die Daten im Recordset -Objekt anzuordnen. Möglicherweise müssen Sie jedoch die Reihenfolge der Daten in einem bereits erstellten Recordset -Objekt ändern. Mit der Sort -Eigenschaft können Sie die Reihenfolge festlegen, in der Zeilen eines Recordset -Objekts traversiert werden. Darüber hinaus bestimmt die Filter -Eigenschaft, welche Zeilen beim Traversieren der Zeilen verfügbar sind.

Mit der Sort -Eigenschaft wird ein String -Wert festgelegt oder zurückgegeben, der die Feldnamen im Recordset -Objekt angibt, nach denen sortiert werden soll. Jeder Name wird durch ein Komma getrennt, und optional folgen ein Leerzeichen und das Schlüsselwort ASC (mit dem das Feld aufsteigend sortiert wird) oder DESC (mit dem das Feld absteigend sortiert wird). Standardmäßig wird ein Feld aufsteigend sortiert, wenn kein Schlüsselwort angegeben wird.

Der Sortiervorgang ist effizient, weil Daten nicht wirklich neu angeordnet werden, sondern lediglich in der von einem Index angegebenen Reihenfolge auf die Daten zugegriffen wird.

Für die Sort -Eigenschaft muss die CursorLocation-Eigenschaft auf adUseClient festgelegt werden. Für jedes Feld, das in der Sort -Eigenschaft angegeben ist, wird ein temporärer Index erstellt, soweit noch kein Index vorhanden ist.

Durch Festlegen der Sort -Eigenschaft auf eine leere Zeichenfolge werden die Zeilen auf die ursprüngliche Reihenfolge zurückgesetzt, und temporäre Indizes werden gelöscht. Vorhandene Indizes werden nicht gelöscht.

Angenommen, ein Recordset-Objekt enthält drei Felder mit den Namen firstName, middleInitial und lastName. Legen Sie die Sort-Eigenschaft auf die Zeichenfolge "" fest, die das Recordset nach Nachnamen in absteigender Reihenfolge und dann nach Vornamen in aufsteigender Reihenfolge sortiert. Der Mittelname wird ignoriert.

Kein Feld, auf das in einer Sortierkriterienzeichenfolge verwiesen wird, kann "ASC" oder "DESC" genannt werden, da diese Namen mit den Schlüsselwörtern ASC und DESC in Konflikt stehen. Weisen Sie einem Feld mit einem in Konflikt stehenden Namen einen Alias zu, indem Sie die AS-Schlüsselwort (keyword) in der Abfrage verwenden, die das Recordset zurückgibt.

Weitere Informationen zum Filtern von Recordset -Objekten finden Sie im Abschnitt "Filtern der Ergebnisse" weiter unten in diesem Thema.

Suchen eines bestimmten Datensatzes

ADO enthält die Methoden Find und Seek für die Suche nach einem bestimmten Datensatz in einem Recordset -Objekt. Die Find -Methode wird von verschiedenen Anbietern unterstützt, ist jedoch auf ein einzelnes Suchkriterium beschränkt. Die Seek -Methode unterstützt die Suche mit mehreren Kriterien, wird jedoch nicht von vielen Anbietern unterstützt.

Indizes für Felder können die Leistung der Find-Methode und der Sort- und Filter-Eigenschaften des Recordset-Objekts erheblich verbessern. Sie können einen internen Index für ein Field-Objekt erstellen, indem Sie dessen dynamische Optimize-Eigenschaft festlegen. Diese dynamische Eigenschaft wird der Properties-Auflistung des Field-Objekts hinzugefügt, wenn Sie die CursorLocation-Eigenschaft auf adUseClient festlegen. Denken Sie daran, dass dieser Index in ADO intern ist– Sie können keinen Zugriff darauf erhalten oder ihn für andere Zwecke verwenden. Außerdem unterscheidet sich dieser Index von der Index-Eigenschaft des Recordset-Objekts.

Mit der Find -Methode wird schnell nach einem Wert in einer Spalte (Feld) eines Recordset -Objekts gesucht. Oft kann die Verarbeitungsgeschwindigkeit der Find -Methode für eine Spalte optimiert werden, indem Sie die Optimize -Eigenschaft zum Erstellen eines Indexes verwenden.

Mit der Find -Methode wird die Suche auf die Inhalte eines einzigen Felds eingeschränkt. Für die Seek -Methode muss ein Index vorhanden sein, und außerdem gelten weitere Einschränkungen. Wenn Sie in mehreren Feldern suchen müssen, die nicht die Basis eines Indexes darstellen, oder wenn der Anbieter keine Indizes unterstützt, können Sie die Ergebnisse mithilfe der Filter-Eigenschaft des Recordset-Objekts einschränken.

Suchen

Die Find-Methode durchsucht ein Recordset-Objekt nach der Zeile, die ein angegebenes Kriterium erfüllt. Optional können die Richtung der Suche, die Startzeile und der Offset von der Anfangszeile angegeben werden. Wenn das Kriterium erfüllt ist, wird die aktuelle Zeilenposition im gefundenen Datensatz festgelegt. Andernfalls wird die Position abhängig von der Suchrichtung auf das Ende (oder den Anfang) des Recordset-Objekts festgelegt.

Für das Kriterium kann nur ein einspaltiger Name angegeben werden. Mehrspaltige Suchvorgänge werden demnach von dieser Methode nicht unterstützt.

Der Vergleichsoperator für das Kriterium kann ">" (größer als), "<" (kleiner als), "=" (gleich), ">=" (größer als oder gleich), "<=" (kleiner oder gleich), "<>" (ungleich) oder "LIKE" (Musterabgleich) sein.

Der Wert des Kriteriums kann eine Zeichenfolge, eine Gleitkommazahl oder ein Datum sein. Zeichenfolgenwerte werden in einfache Anführungszeichen oder "#" (Nummernzeichen) gesetzt (z. B. "state = 'WA'" oder "state = #WA#"). Datumswerte werden durch "#" (Nummernzeichen) getrennt (z. B. "start_date > #22.7.97#").

Ist der Vergleichsoperator "like", kann der Zeichenfolgenwert ein Sternchen (*) enthalten, um nach einem oder mehreren Vorkommen eines beliebigen Zeichens oder einer beliebigen Teilzeichenfolge zu suchen. Bei einer Suche nach "state like 'M*'" werden beispielsweise Maine und Massachusetts gefunden. Sie können auch führende und nachfolgende Sternchen verwenden, um nach einer Teilzeichenfolge innerhalb eines Werts zu suchen. Bei einer Suche nach "state like '*as*'" werden Alaska, Arkansas und Massachusetts gefunden.

Sternchen können nur am Ende der Kriterienzeichenfolge oder sowohl am Anfang als auch am Ende der Kriterienzeichenfolge (siehe oben) verwendet werden. Ein Sternchen kann nicht als führender Platzhalter ('*str') oder als eingebetteter Platzhalter ('s*r') verwendet werden. Dies würde einen Fehler verursachen.

Seek-Methode und Index-Eigenschaft

Verwenden Sie die Seek-Methode in Verbindung mit der Index-Eigenschaft, falls der zugrunde liegende Anbieter Indizes für das Recordset-Objekt unterstützt. Mit der Supports(adSeek)-Methode bestimmen Sie, ob der zugrunde liegende Anbieter Seek unterstützt, und mit der Supports(adIndex)-Methode, ob der Anbieter Indizes unterstützt. (Beispielsweise werden Seek und Index vom OLE DB-Anbieter für Microsoft Jet unterstützt.)

Wenn Seek die gewünschte Zeile nicht findet, tritt kein Fehler auf, und die Zeile wird am Ende des Recordset -Objekts positioniert. Legen Sie die Index -Eigenschaft auf den gewünschten Index fest, bevor Sie diese Methode ausführen.

This method is supported only with server-side cursors. Seek is not supported when the Recordset object's CursorLocation property value is adUseClient.

Diese Methode kann nur verwendet werden, wenn das Recordset -Objekt mit dem Wert adCmdTableDirect für CommandTypeEnum geöffnet wurde.

Filtern der Ergebnisse

Mit der Find -Methode wird die Suche auf die Inhalte eines einzigen Felds eingeschränkt. Für die Seek -Methode muss ein Index vorhanden sein, und außerdem gelten weitere Einschränkungen. Wenn Sie in mehreren Feldern suchen müssen, die nicht die Basis eines Indexes darstellen, oder wenn der Anbieter keine Indizes unterstützt, können Sie die Ergebnisse mithilfe der Filter -Eigenschaft des Recordset -Objekts einschränken.

Verwenden Sie die Filter-Eigenschaft, um Datensätze in einem Recordset-Objekt gezielt herauszufiltern. Das gefilterte Recordset-Objekt wird zum aktuellen Cursor. Dies bedeutet, dass Datensätze, die die Filterkriterien nicht erfüllen, erst im Recordset verfügbar sind, wenn der Filter entfernt wird. Andere Eigenschaften, deren Rückgabewerte auf dem aktuellen Cursor basieren, werden dadurch beeinflusst, wie z. B. AbsolutePosition, AbsolutePage, RecordCount und PageCount. Das liegt daran, dass der aktuelle Datensatz durch das Festlegen der Filter-Eigenschaft auf einen bestimmten Wert zum ersten Datensatz wechselt, der dem neuen Wert entspricht.

The Filter property takes a variant argument. This value represents one of three methods for using the Filter property: a criteria string, a FilterGroupEnum constant, or an array of bookmarks. For more information, see Filtering with a Criteria String, Filtering with a Constant, and Filtering with Bookmarks later in this topic.

Hinweis

[!HINWEIS] Wenn Sie die Daten kennen, die Sie auswählen möchten, ist es gewöhnlich effizienter ein Recordset -Objekt mit einer SQL-Anweisung zu öffnen, die das Resultset wirksam filtert, anstatt die Filter -Eigenschaft zu verwenden.

Verwenden Sie die adFilterNone -Konstante, um einen Filter aus einem Recordset -Objekt zu entfernen. Das Festlegen der Filter -Eigenschaft auf eine leere Zeichenfolge ("") hat dieselbe Wirkung wie das Verwenden der adFilterNone -Konstante.

Filtern mit einer Kriterienzeichenfolge

Die Kriterienzeichenfolge besteht aus Klauseln im Format FieldName Operator Value (z. B. "LastName = 'Smith'"). Sie können Verbundklauseln erstellen, indem Sie einzelne Klauseln mit AND verketten (z. B. "LastName = 'Smith' AND FirstName = 'John'") und OR (z. B. ). Sie können Verbundklauseln erstellen, indem Sie einzelne Klauseln mit AND verketten (z. B. "LastName = 'Smith' AND FirstName = 'John'") und OR (z. B. "LastName = 'Smith' OR LastName = 'Jones'"). Halten Sie sich für Kriterienzeichenfolgen an die folgenden Richtlinien:

Feldname muss ein gültiger Feldname aus dem Recordset-Objekt sein. Wenn der Feldname Leerzeichen enthält, müssen Sie ihn in eckige Klammern einschließen.
Der Operator muss einer der folgenden Sein: <, , >=<, =, <>>, = oder LIKE.
Value ist der Wert, mit dem Sie die Feldwerte vergleichen (z. B. "Smith", #8/24/95#, 12,345 oder $50,00). Verwenden Sie einfache Anführungszeichen (') mit Zeichenfolgen und Nummernzeichen (#) mit Datumsangaben. Für Zahlen können Sie Dezimalzeichen, Dollarzeichen und die wissenschaftliche Schreibweise verwenden. Wenn Operator gleich LIKE ist, können für Wert Platzhalterzeichen verwendet werden. Nur das Sternchen (*) und das Prozentzeichen (%) sind als Platzhalter zulässig, und sie müssen das letzte Zeichen in der Zeichenfolge sein. Wert darf nicht NULL sein.

Hinweis

Um im Filter einfache Anführungszeichen (') für Wert einzuschließen, verwenden Sie zwei einfache Anführungszeichen zur Darstellung eines Anführungszeichens. Um beispielsweise nach O'Malley zu filtern, sollte die Kriterienzeichenfolge "col1 = 'O''Malley'" lauten.

Um einfache Anführungszeichen am Anfang und am Ende des Filterwerts einzuschließen, schließen Sie die Zeichenfolge in Nummernzeichen (#) ein. Um beispielsweise nach '1' zu filtern, sollte die Kriterienzeichenfolge "col1 = #'1'#" lauten.

Hinsichtlich AND und OR gibt es keine Rangfolge. Die Klauseln können in Klammern zusammengefasst werden. Sie können jedoch, wie im Folgenden dargestellt, Klauseln nicht gruppieren, die mit OR verknüpft sind, und dann die Gruppe mit einer anderen Klausel mit AND verknüpfen:

 
(LastName = 'Smith' OR LastName = 'Jones') AND FirstName = 'John'

Sie würden diesen Filter stattdessen wie folgt erstellen:

 
(LastName = 'Smith' AND FirstName = 'John') OR (LastName = 'Jones' AND FirstName = 'John')

In einer LIKE-Klausel können Sie am Anfang und Ende des Musters (z. B. LastName Like '*mit*') oder nur am Ende des Musters (z. B. ) oder nur am Ende des Musters (z. B. LastName like 'Smit*') verwenden.

Filtern mit einer Konstante

Die folgenden Konstanten sind für das Filtern von Recordset-Objekten verfügbar.

Konstante	Beschreibung
adFilterAffectedRecords	Filter für das Anzeigen aller Datensätze, die vom letzten Aufruf von Delete, Resync, UpdateBatch oder CancelBatch betroffen waren.
adFilterConflictingRecords	Filter zum Anzeigen der Datensätze, für die bei der letzten Batchaktualisierung ein Fehler erzeugt wurde.
adFilterFetchedRecords	Filter zum Anzeigen der Datensätze im aktuellen Cache – das heißt, die Ergebnisse des letzten Aufrufs zum Abrufen von Datensätzen aus der Datenbank.
adFilterNone	Entfernt den aktuellen Filter und stellt alle Datensätze in der Ansicht wieder her.
adFilterPendingRecords	Filter zum Anzeigen aller Datensätze, die geändert, aber noch nicht an den Server gesendet wurden. Dies betrifft nur den Batchaktualisierungsmodus.

Die Filterkonstanten erleichtern das Lösen einzelner Datensatzkonflikte im Batchaktualisierungsmodus, indem Sie z. B. nur die Datensätze anzeigen können, die vom letzten Aufruf der UpdateBatch-Methode betroffen waren. Dies ist im folgenden Beispiel veranschaulicht:

 
'BeginDeleteGroup 
    'add some bogus records 
    With objRs1 
        For i = 0 To 8 
            .AddNew 
            .Fields("CompanyName") = "Shipper Number " & i + 1 
            .Fields("Phone") = "(425) 555-000" & (i + 1) 
            .Update 
        Next i 
         
    're-connect & update 
        .ActiveConnection = GetNewConnection 
        .UpdateBatch 
         
    'filter on newly added records 
        .Filter = adFilterAffectedRecords 
        Debug.Print "Deleting the " & .RecordCount & _ 
                    " records you just added." 
         
    'delete the newly added bogus records 
        .Delete adAffectGroup 
        .Filter = adFilterNone 
        Debug.Print .RecordCount & " records remain." 
         
        .Close 
    End With 
'EndDeleteGroup

Filtern mit Lesezeichen

Finally, you can pass a variant array of bookmarks to the Filter property. The resulting cursor will contain only those records whose bookmark was passed in to the property. Im folgenden Codebeispiel wird ein Array von Lesezeichen aus den Datensätzen in einem Recordset erstellt, die im Feld ProductName ein "B" aufweisen. It then passes the array to the Filter property and displays information about the resulting filtered Recordset.

 
'BeginFilterBkmk 
    Dim vBkmkArray() As Variant 
    Dim i As Integer 
 
    'Recordset created using "SELECT * FROM Products" as command. 
    'So, we will check to see if ProductName has a capital B, and 
    'if so, add to the array. 
    i = 0 
    Do While Not objRs.EOF 
        If InStr(1, objRs("ProductName"), "B") Then 
            ReDim Preserve vBkmkArray(i) 
            vBkmkArray(i) = objRs.Bookmark 
            i = i + 1 
            Debug.Print objRs("ProductName") 
        End If 
        objRs.MoveNext 
    Loop 
     
    'Filter using the array of bookmarks. 
    objRs.Filter = vBkmkArray 
     
    objRs.MoveFirst 
    Do While Not objRs.EOF 
        Debug.Print objRs("ProductName") 
        objRs.MoveNext 
    Loop 
    'EndFilterBkmk

Erstellen eines Klons eines Recordsets

Mithilfe der Clone -Methode erstellen Sie mehrere doppelte Recordset -Objekte, insbesondere wenn Sie mehr als einen aktuellen Datensatz in einem bestimmten Recordset verwalten möchten. Das Verwenden der Clone -Methode ist effizienter als das Erstellen und Öffnen eines neuen Recordset -Objekts mit der gleichen Definition wie das Original.

Der aktuelle Datensatz eines neu erstellten Klons ist ursprünglich auf den ersten Datensatz festgelegt. Der aktuelle Datensatzzeiger in einem geklonten Recordset -Objekt wird nicht mit dem Original synchronisiert, und umgekehrt. Sie können in jedem Recordset -Objekt unabhängig navigieren.

An einem Recordset -Objekt vorgenommene Änderungen werden unabhängig vom Cursortyp in allen Klonen des Objekts angezeigt. Nach dem Ausführen von Requery für das ursprüngliche Recordset -Objekt werden die Klone jedoch nicht mehr mit dem Original synchronisiert.

Durch das Schließen des ursprünglichen Recordset -Objekts werden die Kopien nicht geschlossen. Und durch das Schließen einer Kopie werden weder das Original noch andere Kopien geschlossen.

Sie können ein Recordset-Objekt nur klonen, wenn es Lesezeichen unterstützt. Textmarkenwerte sind austauschbar; d. h., ein Textmarkenverweis eines Recordset-Objekts verweist auf den gleichen Datensatz in den Klonen.

Freigeben über