Scrollen und Abrufen von Zeilen: Kennzeichnen von Zeilen in ODBC
Gilt für:
SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)
Ein Lesezeichen ist ein Wert, der verwendet wird, um eine Zeile mit Daten zu identifizieren. Die Bedeutung des Lesezeichenwerts ist nur dem Treiber oder der Datenquelle bekannt. Der Wert kann so einfach wie eine Zeilennummer oder so komplex wie eine Datenträgeradresse sein. In ODBC fordert die Anwendung ein Lesezeichen für bestimmte Zeilen an, speichert es und gibt es an den Cursor für die Rückgabe an die Zeile zurück.
Beim Abrufen von Zeilen mit SQLFetchScroll kann eine Anwendung eine Textmarke als Grundlage für die Auswahl der Anfangszeile verwenden. Dies ist eine Form der absoluten Adressierung, da sie nicht von der aktuellen Cursorposition abhängt. Um zu einer mit Textmarken versehenen Zeile zu scrollen, ruft die Anwendung SQLFetchScroll mit einer FetchOrientation von SQL_FETCH_BOOKMARK auf. Dieser Vorgang verwendet das Lesezeichen, auf das das SQL_ATTR_FETCH_BOOKMARK_PTR-Optionsattribut zeigt. Es gibt das Rowset zurück, das mit der Zeile beginnt, die von diesem Lesezeichen identifiziert wird. Eine Anwendung kann einen Offset für diesen Vorgang im FetchOffset-Argument des Aufrufs von SQLFetchScroll angeben. Wenn ein Offset angegeben ist, wird die erste Zeile des zurückgegebenen Rowsets durch Hinzufügen der Zahl im FetchOffset-Argument zu der Zahl der Zeile, die vom Lesezeichen identifiziert wird, bestimmt. Der ODBC-Treiber für SQL Server Native Client unterstützt nur Lesezeichen für statische Cursor und Keysetcursor. Wenn beim Festlegen von Lesezeichen ein dynamischer Cursor angefordert wird, wird stattdessen ein Keysetcursor geöffnet.
Lesezeichen können auch mit der SQLBulkOperations-Funktion verwendet werden, um Vorgänge für eine Reihe von Zeilen auszuführen, die mit der Textmarke beginnen.