CRecordset::SetRowsetCursorPosition
Verschiebt den Cursor in einer Zeile innerhalb des aktuellen Rowsets.
void SetRowsetCursorPosition(
WORD wRow,
WORD wLockType = SQL_LOCK_NO_CHANGE
);
Parameter
wRow
Die einsbasierte Position einer Zeile im aktuellen Rowset. Dieser Wert kann von 1 bis zur Größe des Rowsets reichen.wLockType
Ein Wert, anzugeben, wie die Zeile gesperrt, nachdem sie aktualisiert wurde. Details finden Sie Hinweise.
Hinweise
Wenn Sie das gesammelte Abrufen von Zeilen implementiert, werden Datensätze von Rowsets abgerufen, in denen der erste Datensatz im abgerufenen Rowset der aktuelle Datensatz ist. Um einen anderen Datensatz innerhalb des Rowsets den aktuellen Datensatz auszuführen, rufen Sie SetRowsetCursorPosition auf. Beispielsweise können Sie SetRowsetCursorPosition mit der GetFieldValue-Memberfunktion kombinieren, um die Daten aus jedem Datensatz des Recordsets dynamisch abzurufen.
Um SetRowsetCursorPosition zu verwenden, müssen Sie das gesammelte Abrufen von Zeilen implementiert haben CRecordset::useMultiRowFetch mithilfe der Option des dwOptions-Parameters in der Geöffnet-Memberfunktion angeben.
SetRowsetCursorPosition ruft die ODBC-API-Funktion SQLSetPos auf. Der wLockType-Parameter gibt den Zustand der Sperre der Zeile an, nachdem SQLSetPos ausgeführt hat. Die folgende Tabelle beschreibt die möglichen Werte für wLockTyp E.
wLockType |
Description |
|---|---|
SQL_LOCK_NO_CHANGE (Standardwert) |
Der Treiber oder die Datenquelle wird sichergestellt, dass die Zeile im gesperrten oder entsperrten Zustand identisch ist, die sie war, bevor SetRowsetCursorPosition aufgerufen wurde. |
SQL_LOCK_EXCLUSIVE |
Der Treiber oder die Datenquelle sperrt die Zeile ausschließlich. Nicht alle Datenquellen unterstützen diesen Typ der Sperre. |
SQL_LOCK_UNLOCK |
Der Treiber oder die Datenquelle wird die Zeile. Nicht alle Datenquellen unterstützen diesen Typ der Sperre. |
Weitere Informationen zu SQLSetPos, finden Sie unter Windows SDK. Weitere Informationen über das gesammelte Abrufen von Zeilen, finden Sie im Artikel Recordset: Datensätzen in einer Sammeloperation (ODBC).
Anforderungen
Header: afxdb.h