Freigeben über


Eigenschaften und Verhaltensweisen von Rowsets

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

OLE DB-Treiber herunterladen

Nachfolgend sind die Eigenschaften von Rowsets im OLE DB-Treiber für SQL Server aufgeführt:

Eigenschafts-ID BESCHREIBUNG
DBPROP_ABORTPRESERVE R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Das Verhalten eines Rowsets, nachdem ein Abbruchvorgang von dieser Eigenschaft bestimmt wurde.

VARIANT_FALSE: Der OLE DB-Treiber für SQL Server markiert Rowsets nach einem Abbruchvorgang als ungültig. Die Funktionalität des Rowsetobjekts ist beinahe verloren. Es werden nur IUnknown-Vorgänge und die Freigabe ausstehender Zeilen- und Accessorhandles unterstützt.

VARIANT_TRUE: Der OLE DB-Treiber für SQL Server behält ein gültiges Rowset bei.
DBPROP_ACCESSORDER R/W: Lesen/Schreiben

Standardwert: DBPROPVAL_AO_RANDOM

Beschreibung: Reihenfolge des Zugriffs. Die Reihenfolge, in der auf die Spalten im Rowset zugegriffen werden muss.

DBPROPVAL_AO_RANDOM: Auf die Spalte kann in beliebiger Reihenfolge zugegriffen werden.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Auf als Speicherobjekte gebundene Spalten kann nur in einer sequenziellen, von der Spaltenordnungszahl bestimmten Reihenfolge zugegriffen werden.

DBPROPVAL_AO_SEQUENTIAL: Auf alle Spalten muss in einer sequenziellen, von der Spaltenordnungszahl bestimmten Reihenfolge zugegriffen werden.
DBPROP_APPENDONLY Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_BLOCKINGSTORAGEOBJECTS R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: Die Speicherobjekte im OLE DB-Treiber für SQL Server blockieren die Verwendung anderer Rowsetmethoden.
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt Lesezeichen für die Rowsetzeilenidentifikation, wenn DBPROP_BOOKMARKS oder DBPROP_LITERALBOOKMARKS den Wert VARIANT_TRUE aufweist.

Das Festlegen einer der beiden Eigenschaft auf VARIANT_TRUE aktiviert keine Rowsetpositionierung durch Lesezeichen. Legen Sie DBPROP_IRowsetLocate oder DBPROP_IRowsetScroll auf VARIANT_TRUE fest, um ein Rowset zu erstellen, das die Rowsetpositionierung durch Lesezeichen unterstützt.

Der OLE DB-Treiber für SQL Server verwendet einen Microsoft SQL Server-Cursor zur Unterstützung eines Rowsets, das Lesezeichen enthält. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.

Hinweis: Wenn diese Eigenschaften so festgelegt werden, dass ein Konflikt mit anderen cursordefinierenden Eigenschaften des OLE DB-Treibers für SQL Server entsteht, wird ein Fehler ausgelöst. Falls Sie beispielsweise DBPROP_BOOKMARKS auf VARIANT_TRUE festlegen, wenn DBPROP_OTHERINSERT ebenfalls den Wert VARIANT_TRUE aufweist, tritt ein Fehler auf, wenn der Consumer versucht, ein Rowset zu öffnen.
DBPROP_BOOKMARKSKIPPED R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server gibt DB_E_BADBOOKMARK zurück, wenn der Consumer beim Positionieren oder Suchen eines mit einem Lesezeichen versehenen Rowsets ein ungültiges Lesezeichen angibt.
DBPROP_BOOKMARKTYPE R/W: Schreibgeschützt

Standardwert: DBPROPVAL_BMK_NUMERIC

Beschreibung: Der OLE DB-Treiber für SQL Server implementiert ausschließlich numerische Lesezeichen. Ein OLE DB-Treiber für SQL Server-Lesezeichen ist eine 32-Bit-Ganzzahl ohne Vorzeichen vom Typ DBTYPE_UI4.
DBPROP_CACHEDEFERRED Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt rückwärts gerichtete Abruf- und Scrollvorgänge in nicht sequenziellen Rowsets. Der OLE DB-Treiber für SQL Server erstellt ein durch Cursor unterstütztes Rowset, wenn entweder DBPROP_CANFETCHBACKWARDS oder DBPROP_CANSCROLLBACKWARDS den Wert VARIANT_TRUE aufweist. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.
DBPROP_CANHOLDROWS R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server gibt standardmäßig DB_E_ROWSNOTRELEASED zurück, wenn der Consumer versucht, weitere Zeilen für ein Rowset abzurufen, während für die aktuell im Rowset befindlichen Zeilen Änderungen ausstehen. Dieses Verhalten kann geändert werden.

Das Festlegen von DBPROP_CANHOLDROWS und DBPROP_IRowsetChange auf VARIANT_TRUE impliziert ein mit Lesezeichen versehenes Rowset. Wenn beide Eigenschaften auf VARIANT_TRUE festgelegt sind, ist die IRowsetLocate-Schnittstelle für das Rowset verfügbar, und sowohl DBPROP_BOOKMARKS als auch DBPROP_LITERALBOOKMARKS weisen den Wert VARIANT_TRUE auf.

Rowsets des OLE DB-Treibers für SQL Server, die Lesezeichen enthalten, werden von SQL Server-Cursorn unterstützt.
DBPROP_CHANGEINSERTEDROWS R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Diese Eigenschaft kann nur auf VARIANT_TRUE festgelegt werden, wenn das Rowset einen über einen keysetgesteuerten Cursor verwendet.
DBPROP_COLUMNRESTRICT R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server legt die Eigenschaft auf VARIANT_TRUE fest, wenn eine Spalte in einem Rowset nicht vom Consumer geändert werden kann. Andere Spalten im Rowset können möglicherweise aktualisiert werden, und die Zeilen selbst können gelöscht werden.

Wenn die Eigenschaft auf VARIANT_TRUE festgelegt ist, überprüft der Consumer das dwFlags-Element der DBCOLUMNINFO-Struktur, um zu bestimmen, ob der Wert einer einzelnen Spalte geschrieben werden kann oder nicht. Für veränderbare Spalten weist dwFlags DBCOLUMNFLAGS_WRITE auf.
DBPROP_COMMANDTIMEOUT R/W: Lesen/Schreiben

Standardwert: 0

Beschreibung: Der OLE DB-Treiber für SQL Server löst für die ICommand::Execute-Methode standardmäßig keinen Timeout aus.
DBPROP_COMMITPRESERVE R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Das Verhalten eines Rowsets, nachdem ein Commitvorgang von dieser Eigenschaft bestimmt wurde.

VARIANT_TRUE: Der OLE DB-Treiber für SQL Server behält ein gültiges Rowset bei.

VARIANT_FALSE: Der OLE DB-Treiber für SQL Server markiert Rowsets nach einem Commitvorgang als ungültig. Die Funktionalität des Rowsetobjekts ist beinahe verloren. Es werden nur IUnknown-Vorgänge und die Freigabe ausstehender Zeilen- und Accessorhandles unterstützt.
DBPROP_DEFERRED R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Bei Festlegung auf VARIANT_TRUE versucht der OLE DB-Treiber für SQL Server, einen Servercursor für das Rowset zu verwenden. Die Spalten Text, ntext und image werden erst vom Server zurückgegeben, wenn die Anwendung auf sie zugreift.
DBPROP_DELAYSTORAGEOBJECTS R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt den Modus zur sofortigen Aktualisierung für Speicherobjekte.

An Daten in einem sequenziellen Datenstromobjekt vorgenommene Änderungen werden sofort an SQL Server gesendet. Ein Commit für Änderungen wird auf Grundlage des Rowsettransaktionsmodus ausgeführt.
DBPROP_HIDDENCOLUMNS R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Die Anzahl ausgeblendeter Spalten.

Wenn DBPROP_UNIQUEROWS den Wert VARIANT_TRUE aufweist, gibt die DBPROP_HIDDENCOLUMNS-Eigenschaft die Anzahl der zusätzlichen ausgeblendeten Spalten zurück, die vom Anbieter hinzugefügt wurden, um Zeilen innerhalb des Rowsets eindeutig zu identifizieren. Diese Spalten werden von IColumnsInfo::GetColumnInfo und IColumnsRowset::GetColumnsRowset zurückgegeben. Sie sind jedoch nicht in der Zeilenanzahl enthalten, die vom pcColumns-Argument zurückgegeben wird, welches wiederum von IColumnsInfo::GetColumnInfo zurückgegeben wird.

Zum Bestimmen der Gesamtzahl der Spalten, die in der prgInfo-Struktur dargestellt werden, die von IColumnsInfo::GetColumnInfo zurückgegeben wird (einschließlich ausgeblendeter Spalten), fügt der Consumer der Spaltenanzahl, die von IColumnsInfo::GetColumnInfo in pcColumns zurückgegeben wird, den Wert von DBPROP_HIDDENCOLUMNS hinzu. Wenn DBPROP_UNIQUEROWS den Wert VARIANT_FALSE aufweist, ist DBPROP_HIDDENCOLUMNS gleich Null.
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt diese Schnittstellen für alle Rowsets.
DBPROP_IColumnsRowset R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt die IColumnsRowset-Schnittstelle.
DBPROP_IConnectionPointContainer R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: IConnectionPointContainer. Wenn VARIANT_TRUE festgelegt ist, unterstützt das Rowset die angegebene Schnittstelle. Wenn VARIANT_FALSE festgelegt ist, unterstützt das Rowset die angegebene Schnittstelle nicht. Anbieter, die eine Schnittstelle unterstützen, müssen auch die Eigenschaft, die dieser Schnittstelle zugeordnet ist, mit dem Wert VARIANT_TRUE unterstützen. Diese Eigenschaften werden hauptsächlich dazu verwendet, Schnittstellen durch <legacyBold>ICommandProperties::SetProperties</legacyBold> anzufordern.
DBPROP_IMultipleResults R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt die IMultipleResults-Schnittstelle.
DBPROP_IRowsetChange DBPROP_IRowsetUpdate R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt die Schnittstellen IRowsetChange und IRowsetUpdate.

Ein mit DBPROP_IRowsetChange gleich VARIANT_TRUE erstelltes Rowset zeigt Verhaltensweisen des Sofortupdatemodus.

Wenn DBPROP_IRowsetUpdate auf VARIANT_TRUE festgelegt ist, weist DBPROP_IRowsetChange ebenfalls den Wert VARIANT_TRUE auf. Das Rowset zeigt das Verhalten des verzögerten Aktualisierungsmodus.

Der OLE DB-Treiber für SQL Server verwendet einen SQL Server-Cursor zur Unterstützung von Rowsets, die entweder IRowsetChange oder IRowsetUpdate verfügbar machen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.
DBPROP_IRowsetIdentity R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt die IRowsetIdentity-Schnittstelle. Wenn ein Rowset diese Schnittstelle unterstützt, geben zwei beliebige Zeilenhandles, die die gleiche zugrunde liegende Zeile darstellen, stets die gleichen Daten und Zustandsinformationen wieder. Consumer können die IRowsetIdentity:: IsSameRow-Methode aufrufen, um zwei Handles zu vergleichen und festzustellen, ob sie auf dieselbe Zeileninstanz verweisen.
DBPROP_IRowsetLocate DBPROP_IRowsetScroll R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server kann die Schnittstellen IRowsetLocate und IRowsetScroll verfügbar machen.

Wenn DBPROP_IRowsetLocate auf VARIANT_TRUE festgelegt ist, weisen DBPROP_CANFETCHBACKWARDS und DBPROP_CANSCROLLBACKWARDS ebenfalls den Wert VARIANT_TRUE auf.

Wenn DBPROP_IRowsetScroll auf VARIANT_TRUE festgelegt ist, weist DBPROP_IRowsetLocate ebenfalls den Wert VARIANT_TRUE auf, und beide Schnittstellen sind für das Rowset verfügbar.

Lesezeichen sind für beide Schnittstellen erforderlich. Der OLE DB-Treiber für SQL Server legt DBPROP_BOOKMARKS und DBPROP_LITERALBOOKMARKS auf VARIANT_TRUE fest, wenn der Consumer eine der beiden Schnittstellen anfordert.

Der OLE DB-Treiber für SQL Server verwendet einen SQL Server-Cursor zur Unterstützung von IRowsetLocate und IRowsetScroll. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.

Wenn diese Eigenschaften so festgelegt werden, dass ein Konflikt mit anderen cursordefinierenden Eigenschaften des OLE DB-Treibers für SQL Server entsteht, wird ein Fehler ausgelöst. Falls Sie beispielsweise DBPROP_IRowsetScroll auf VARIANT_TRUE festlegen, wenn DBPROP_OTHERINSERT ebenfalls den Wert VARIANT_TRUE aufweist, tritt ein Fehler auf, wenn der Consumer versucht, ein Rowset zu öffnen.
DBPROP_IRowsetResynch R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server macht bei Bedarf die IRowsetResynch-Schnittstelle verfügbar. Der OLE DB-Treiber für SQL Server kann die Schnittstelle für ein beliebiges Rowset verfügbar machen.
DBPROP_ISupportErrorInfo R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: Der OLE DB-Treiber für SQL Server macht die ISupportErrorInfo-Schnittstelle für Rowsets verfügbar.
DBPROP_ILockBytes Diese Schnittstelle wird vom OLE DB-Treiber für SQL Server nicht implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_ISequentialStream R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server macht die ISequentialStream-Schnittstelle verfügbar, um lange Daten mit variabler Länge zu unterstützen, die in SQL Server gespeichert sind.
DBPROP_IStorage Diese Schnittstelle wird vom OLE DB-Treiber für SQL Server nicht implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_IStream Diese Schnittstelle wird vom OLE DB-Treiber für SQL Server nicht implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_IMMOBILEROWS R/W: Lesen/Schreiben

Standardwert: VARIANT_TRUE

Beschreibung: Die Eigenschaft weist nur für SQL Server-Keysetcursor den Wert VARIANT_TRUE auf. Für alle anderen Cursor lautet sie VARIANT_FALSE.

VARIANT_TRUE: Das Rowset ordnet die eingefügten oder aktualisierten Zeilen nicht neu an. Für IRowsetChange::InsertRow werden Zeilen am Ende des Rowsets angezeigt. Für IRowsetChange::SetData wird die Position der aktualisierten Zeilen nicht geändert, wenn das Rowset nicht sortiert ist. Wenn das Rowset sortiert ist und IRowsetChange::SetData eine Spalte ändert, die verwendet wird, um das Rowset zu sortieren, wird die Zeile nicht verschoben. Wenn das Rowset auf einem Satz Schlüsselspalten basiert (in der Regel ein Rowset, für das DBPROP_OTHERUPDATEDELETE den Wert VARIANT_TRUE, DBPROP_OTHERINSERT jedoch den Wert VARIANT_FALSE aufweist), entspricht das Ändern des Werts einer Schlüsselspalte in der Regel dem Löschen der aktuellen Zeile und dem Einfügen einer neuen. Aus diesem Grund kann es so scheinen, als würde sich die Spalte verschieben oder aus dem Rowset entfernt werden, wenn DBPROP_OWNINSERT den Wert VARIANT_FALSE aufweist, obwohl die Eigenschaft DBPROP_IMMOBILEROWS auf VARIANT_TRUE festgelegt ist.

VARIANT_FALSE: Wenn das Rowset sortiert ist, werden eingefügte Zeilen in der richtigen Reihenfolge des Rowsets angezeigt. Wenn das Rowset nicht sortiert ist, wird die eingefügte Zeile am Ende angezeigt. Wenn IRowsetChange::SetData eine Spalte ändert, die verwendet wird, um das Rowset zu sortieren, wird die Zeile verschoben. Wenn das Rowset nicht sortiert ist, wird die Position der Zeile nicht verändert.
DBPROP_LITERALIDENTITY R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: Diese Eigenschaft weist immer den Wert VARIANT_TRUE auf.
DBPROP_LOCKMODE R/W: Lesen/Schreiben

Standardwert: DBPROPVAL_LM_NONE

Beschreibung: Die vom Rowset ausgeführte Sperrebene (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

Hinweis: Bei Verwendung der Momentaufnahmeisolation in einer Transaktion und wenn ein Rowset mithilfe eines Keyset- oder dynamischen Servercursors geöffnet wird und der Sperrmodus auf DBPROPVAL_LM_SINGLEROW festgelegt ist, tritt beim Abrufen einer Zeile ein Fehler auf, wenn ein anderer Benutzer diese Zeile seit Beginn der Transaktion aktualisiert hat. Für andere Cursortypen und Sperrmodi gilt: Wenn ein anderer Benutzer die Zeile seit Beginn der Transaktion aktualisiert hat, tritt erst dann ein Fehler auf, wenn der Benutzer versucht, die Zeile zu aktualisieren. In beiden Fällen werden diese Fehler vom Server automatisch generiert.
DBPROP_MAXOPENROWS R/W: Schreibgeschützt

Standardwert: 0

Beschreibung: Die Anzahl von Zeilen, die in Rowsets aktiv sein können, wird nicht vom OLE DB-Treiber für SQL Server eingeschränkt.
DBPROP_MAXPENDINGROWS R/W: Schreibgeschützt

Standardwert: 0

Beschreibung: Die Anzahl von Rowsetzeilen mit ausstehenden Änderungen wird vom OLE DB-Treiber für SQL Server nicht eingeschränkt.
DBPROP_MAXROWS R/W: Lesen/Schreiben

Standardwert: 0

Beschreibung: Der OLE DB-Treiber für SQL Server schränkt die Anzahl von Zeilen in einem Rowset standardmäßig nicht ein. Wenn der Consumer DBPROP_MAXROWS festlegt, verwendet der OLE DB-Treiber für SQL Server die SET ROWCOUNT-Anweisung, um die Anzahl der Zeilen im Rowset einzuschränken.

SET ROWCOUNT kann unbeabsichtigte Folgen bei der Ausführung der SQL Server-Anweisung nach sich ziehen. Weitere Informationen finden Sie unter SET ROWCOUNT.
DBPROP_MAYWRITECOLUMN Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_MEMORYUSAGE Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_NOTIFICATIONGRANULARITY Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_NOTIFICATIONPHASES R/W: Schreibgeschützt

Standard: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt alle Benachrichtigungsphasen.
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE R/W: Schreibgeschützt

Standard: DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Beschreibung: Die Benachrichtigungsphasen des OLE DB-Treibers für SQL Server können abgebrochen werden, bevor ein Versuch unternommen wird, die angegebene Änderung des Rowsets durchzuführen. Der OLE DB-Treiber für SQL Server unterstützt keinen Phasenabbruch, nachdem der Versuch abgeschlossen wurde.
DBPROP_ORDEREDBOOKMARKS Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Das Festlegen von Eigenschaften zum Ändern der Sichtbarkeit führt dazu, dass der OLE DB-Treiber für SQL Server SQL Server-Cursor zur Unterstützung des Rowsets verwendet. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.
DBPROP_QUICKRESTART R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Bei Festlegung auf VARIANT_TRUE versucht der OLE DB-Treiber für SQL Server, einen Servercursor für das Rowset zu verwenden.
DBPROP_REENTRANTEVENTS R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: Die Rowsets des OLE DB-Treibers für SQL Server sind eintrittsinvariant und können DB_E_NOTREENTRANT zurückgeben, wenn ein Consumer versucht, über einen Benachrichtigungsrückruf auf eine nicht eintrittsinvariante Rowsetmethode zuzugreifen.
DBPROP_REMOVEDELETED R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server ändert den Wert der Eigenschaft basierend auf der Sichtbarkeit von Änderungen an SQL Server-Daten, die vom Rowset verfügbar gemacht werden.

VARIANT_TRUE: Zeilen, die vom Consumer oder anderen SQL Server-Benutzern gelöscht werden, werden beim Aktualisieren eines Rowsets aus dem Rowset entfernt. DBPROP_OTHERINSERT weist den Wert VARIANT_TRUE auf.

VARIANT_FALSE: Zeilen, die vom Consumer oder anderen SQL Server-Benutzern gelöscht werden, werden beim Aktualisieren eines Rowsets aus dem Rowset nicht entfernt. Der Zeilenstatuswert für gelöschte SQL Server-Zeilen im Rowset ist DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT weist den Wert VARIANT_TRUE auf.

Diese Eigenschaft verfügt nur über einen Wert für Rowsets, die von SQL Server-Cursorn unterstützt werden. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.

Wenn die DBPROP_REMOVEDELETED-Eigenschaft auf einem Keysetcursor-Rowset implementiert wird, werden gelöschte Zeilen zum Zeitpunkt des Abrufens entfernt, und Methoden zum Abrufen von Zeilen wie GetNextRows und GetRowsAt können beide S_OK und weniger Zeilen als angefordert zurückgeben. Beachten Sie, dass dieses Verhalten nicht die DB_S_ENDOFROWSET-Bedingung anzeigt und dass die Anzahl der zurückgegebenen Zeilen niemals Null beträgt, wenn noch verbleibende Zeilen vorliegen.
DBPROP_REPORTMULTIPLECHANGES Diese Rowseteigenschaft wird nicht vom OLE DB-Treiber für SQL Server implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.
DBPROP_RETURNPENDINGINSERTS R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Wenn eine Methode zum Abrufen von Zeilen aufgerufen wird, gibt der OLE DB-Treiber für SQL Server keine ausstehenden Einfügezeilen zurück.
DBPROP_ROWRESTRICT R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: OLE DB-Treiber für SQL Server-Rowsets unterstützen keine Zugriffsrechte basierend auf der Zeile. Wenn die IRowsetChange-Schnittstelle für ein Rowset verfügbar gemacht wird, kann die SetData-Methode vom Consumer aufgerufen werden.
DBPROP_ROWSET_ASYNCH R/W: Lesen/Schreiben

Standardwert: 0

Beschreibung: Diese ID sorgt für eine asynchrone Rowsetverarbeitung. Diese Eigenschaft befindet sich in der Gruppe der Rowseteigenschaften und im DBPROPSET_ROWSET-Eigenschaftensatz. Der Typ ist VT_14.

Der einzige Wert in der Bitmaske, der vom OLE DB-Treiber für SQL Server unterstützt wird, ist DBPROPVAL_ASYNCH_INITIALIZE.
DBPROP_ROWTHREADMODEL R/W: Schreibgeschützt

Standardwert: DBPROPVAL_RT_FREETHREAD

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt den Zugriff auf seine Objekte von mehreren Ausführungsthreads eines einzelnen Consumers aus.
DBPROP_SERVERCURSOR R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Sofern festgelegt, wird ein SQL Server-Cursor verwendet, um das Rowset zu unterstützen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.
DBPROP_SERVERDATAONINSERT R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Serverdaten bei Einfügevorgang.

VARIANT_TRUE: Wenn ein Einfügevorgang an den Server übertragen wird, ruft der Anbieter Daten vom Server ab, um den lokalen Zeilencache zu aktualisieren.

VARIANT_FALSE: Der Anbieter ruft keine Serverwerte für neu eingefügte Zeilen ab.
DBPROP_STRONGIDENTITY R/W: Schreibgeschützt

Standardwert: VARIANT_TRUE

Beschreibung: Starke Zeilenidentität. Wenn Einfügevorgänge für ein Rowset zulässig sind (entweder IRowsetChange oder IRowsetUpdate ist TRUE) und DBPROP_UPDATABILITY auf die Unterstützung von InsertRows festgelegt ist, hängt der Wert von DBPROP_STRONGIDENTITY von der DBPROP_CHANGEINSERTEDROWS-Eigenschaft ab (er lautet VARIANT_FALSE, wenn der Wert der DBPROP_CHANGEINSERTEDROWS-Eigenschaft VARIANT_FALSE lautet).
DBPROP_TRANSACTEDOBJECT R/W: Schreibgeschützt

Standardwert: VARIANT_FALSE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt nur Objekte, für die Transaktionen ausgeführt werden. Weitere Informationen finden Sie unter Transaktionen.
DBPROP_UNIQUEROWS R/W: Lesen/Schreiben

Standardwert: VARIANT_FALSE

Beschreibung: Eindeutige Zeilen.

VARIANT_TRUE: Jede Zeile wird durch ihre Spaltenwerte eindeutig identifiziert. Die Gruppe der Spalten, die die Zeile eindeutig identifizieren, weist den DBCOLUMNFLAGS_KEYCOLUMN-Satz in der DBCOLUMNINFO-Struktur auf, die von der GetColumnInfo-Methode zurückgegeben wird.

VARIANT_FALSE: Zeilen werden durch ihre Spaltenwerte eindeutig identifiziert oder nicht. Die Schlüsselspalten sind möglicherweise mit DBCOLUMNFLAGS_KEYCOLUMN gekennzeichnet.
DBPROP_UPDATABILITY R/W: Lesen/Schreiben

Standardwert: 0

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt alle DBPROP_UPDATABILITY-Werte. Durch das Festlegen von DBPROP_UPDATABILITY wird kein änderbares Rowset erstellt. Wenn Sie ein Rowset veränderbar machen möchten, legen Sie DBPROP_IRowsetChange oder DBPROP_IRowsetUpdate fest.

Der OLE DB-Treiber für SQL Server definiert den anbieterspezifischen Eigenschaftensatz DBPROPSET_SQLSERVERROWSET wie in dieser Tabelle dargestellt.

Eigenschafts-ID BESCHREIBUNG
SSPROP_COLUMN_ID Spalte: ColumnID

R/W: Schreibgeschützt

Typ: VT_U12 | VT_ARRAY

Standardwert: VT_EMPTY

Beschreibung: Ein Array ganzzahliger Werte, die die Ordnungsposition (1-basiert) der Ergebnisspalte einer COMPUTE-Klausel innerhalb der aktuellen Transact-SQL-SELECT-Anweisung darstellen. Dies ist die OLE DB-Treiber für SQL Server-Entsprechung des ODBC SQL_CA_SS_COLUMN_ID-Attributs.
SSPROP_DEFERPREPARE Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standardwert: VARIANT_TRUE

Beschreibung: VARIANT_TRUE: Bei der vorbereiteten Ausführung wird die Befehlsvorbereitung verzögert, bis ICommand::Execute aufgerufen oder ein Metaeigenschaftenvorgang ausgeführt wird. Wenn die Eigenschaft festgelegt ist auf

VARIANT_FALSE: Die Anweisung wird vorbereitet, wenn ICommandPrepare::Prepare ausgeführt wird.
SSPROP_IRowsetFastLoad Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standardwert: VARIANT_FALSE

Beschreibung: Legen Sie diese Eigenschaft auf VARIANT_TRUE fest, um durch IOpenRowset::OpenRowset ein FastLoad-Rowset zu öffnen. Sie können diese Eigenschaft nicht in ICommandProperties::SetProperties festlegen.
SSPROP_ISSAsynchStatus Spalte: Nein.

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standardwert: VARIANT_FALSE

Beschreibung: Legen Sie diese Eigenschaft auf VARIANT_TRUE fest, um asynchrone Vorgänge unter Verwendung der ISSAsynchStatus-Schnittstelle zu aktivieren.
SSPROP_ISSDataClassification R/W: Lesen/Schreiben

Typ: VT_BOOL

Standardwert: VARIANT_TRUE

Beschreibung: Der OLE DB-Treiber für SQL Server unterstützt das Abrufen von Vertraulichkeitsklassifizierungsinformationen über die ISSDataClassification-Schnittstelle.
SSPROP_MAXBLOBLENGTH Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_I4

Standardwert: Der Anbieter schränkt die Größe des vom Server zurückgegebenen Texts nicht ein, und der Eigenschaftswert wird auf den zulässigen Höchstwert festgelegt. Beispiel: 2147483647.

Beschreibung: Der OLE DB-Treiber für SQL Server führt eine SET TEXTSIZE-Anweisung aus, um die Länge der Blobdaten (Binary Large Object) zu begrenzen, die in einer SELECT-Anweisung zurückgegeben werden.
SSPROP_NOCOUNT_STATUS Spalte: NoCount

R/W: Schreibgeschützt

Typ: VT_BOOL

Standardwert: VARIANT_FALSE

Beschreibung: Ein boolescher Wert, der den Status von SET NOCOUNT ON/OFF in SQL Server darstellt:

VARIANT_TRUE: wenn SET NOCOUNT ON

VARIANT_FALSE: wenn SET NOCOUNT OFF
SSPROP_QP_NOTIFICATION_MSGTEXT Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_BSTR (1–2000 Zeichen zulässig)

Standardwert: leere Zeichenfolge

Beschreibung: Der Meldungstext der Abfragebenachrichtigung. Dieser ist benutzerdefiniert und weist kein bestimmtes Format auf.
SSPROP_QP_NOTIFICATION_OPTIONS Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_BSTR

Standardwert: leere Zeichenfolge

Beschreibung: Die Abfragebenachrichtigungsoptionen. Diese werden in einer Zeichenfolge mit name=value angegeben. Der Benutzer ist für das Erstellen des Diensts und Lesen von Benachrichtigungen von der Warteschlange verantwortlich. Die Syntax der Zeichenfolge für die Abfragebenachrichtigungsoptionen lautet:

service=<service-name>[;(local database=<database>&#124;broker instance=<broker instance>)]

Beispiel:

service=mySSBService;local database=mydb
SSPROP_QP_NOTIFICATION_TIMEOUT Spalte: Nein

R/W: Lesen/Schreiben

Typ: VT_UI4

Standardwert: 432000 Sekunden (5 Tage)

Minimum: 1 Sekunde

Maximum: 2^31-1 Sekunden

Beschreibung: Die Anzahl der Sekunden, die die Abfragebenachrichtigung aktiv bleiben soll.

Weitere Informationen

Rowsets