CursorType-Eigenschaft (ADO)
Gibt den Typ des Cursors an, der in einem Recordset-Objekt verwendet wird.
Einstellungen und Rückgabewerte
Legt einen CursorTypeEnum-Wert fest oder gibt diesen zurück. Der Standardwert ist adOpenForwardOnly.
Bemerkungen
Verwenden Sie die CursorType-Eigenschaft, um den Cursortyp anzugeben, der beim Öffnen des Recordset-Objekts verwendet werden soll.
Es wird nur eine adOpenStatic-Einstellung unterstützt, wenn die CursorLocation-Eigenschaft auf adUseClient festgelegt ist. Wenn ein nicht unterstützter Wert festgelegt wird, wird kein Fehler angezeigt; stattdessen wird der nächste unterstützte CursorType verwendet.
Wenn ein Anbieter den angeforderten Cursortyp nicht unterstützt, gibt er möglicherweise einen anderen Cursortyp zurück. Die CursorType-Eigenschaft ändert sich so, dass sie dem tatsächlichen Cursortyp entspricht, der verwendet wird, wenn das Recordset-Objekt geöffnet ist. Verwenden Sie die Supports-Methode, um bestimmte Funktionen des zurückgegebenen Cursors zu überprüfen. Nachdem Sie das Recordset geschlossen haben, wird die CursorType-Eigenschaft auf die ursprüngliche Einstellung zurückgesetzt.
Das folgende Diagramm zeigt die Anbieterfunktionalität (identifiziert durch Supports-Methodenkonstanten), die für jeden Cursortyp erforderlich ist.
Für ein Recordset mit diesem CursorType | Muss die Supports-Methode „True“ für alle diese Konstanten zurückgeben |
---|---|
adOpenForwardOnly | Keine |
adOpenKeyset | adBookmark, adHoldRecords, adMovePrevious, adResync |
adOpenDynamic | adMovePrevious |
adOpenStatic | adBookmark, adHoldRecords, adMovePrevious, adResync |
Hinweis
Obwohl Supports(adUpdateBatch) für dynamische und Vorwärtscursor wahr sein kann, sollten Sie für Batchupdates entweder einen Keyset- oder statischen Cursor verwenden. Legen Sie die LockType-Eigenschaft auf adLockBatchOptimistic und die CursorLocation-Eigenschaft auf adUseClient fest, um den Cursordienst für OLE DB zu aktivieren, der für Batchupdates erforderlich ist.
Die CursorType-Eigenschaft bietet bei geschlossenem Recordset Lese-/Schreibzugriff, bei geöffnetem Recordset ist sie schreibgeschützt.
Hinweis
Verwendung des Remotedatendiensts Wenn sie für ein clientseitiges Recordset-Objekt verwendet wird, kann die CursorType-Eigenschaft nur auf adOpenStatic festgelegt werden.
Gilt für
Weitere Informationen
Beispiel für die Eigenschaften „CursorType“, „LockType“ und „EditMode“ (VB)
Eigenschaften CursorType, LockType und EditMode (Beispiel) (VC++)
Supports-Methode