Freigeben über


Eigenschaften und Verhaltensweisen von Rowsets

Dies sind die Rowseteigenschaften des SQL Server Native Client OLEDB-Anbieters.

Eigenschafts-ID

Beschreibung

DBPROP_ABORTPRESERVE

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

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

VARIANT_FALSE: Der SQL Server Native Client OLE DB-Anbieter macht nach einem Abbruchvorgang Rowsets 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 SQL Server Native Client OLE DB-Anbieter behält ein gültiges Rowset bei.

DBPROP_ACCESSORDER

R/W: Lesen/Schreiben

Standard: DBPROPVAL_AO_RANDOM

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

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

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS: Auf als Speicherobjekte gebundene Spalten kann nur in sequenzieller, von der Spaltenordnungszahl bestimmter Reihenfolge zugegriffen werden.

DBPROPVAL_AO_SEQUENTIAL: Auf alle Spalten muss in sequenzieller, von der Spaltenordnungszahl bestimmter Reihenfolge zugegriffen werden.

DBPROP_APPENDONLY

Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_BLOCKINGSTORAGEOBJECTS

R/W: Schreibgeschützt

Standard: VARIANT_TRUE

Beschreibung: Die Speicherobjekte des SQL Server Native Client OLE DB-Anbieters blockieren mithilfe anderer Rowsetmethoden.

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt Lesezeichen für die Rowset-Zeilenidentifikation, 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 SQL Server Native Client OLE DB-Anbieter verwendet einen MicrosoftSQL Server-Cursor zur Unterstützung eines Rowsets, das Lesezeichen enthält. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor.

HinweisHinweis
Wenn diese Eigenschaften so festgelegt werden, dass ein Konflikt mit anderen cursordefinierenden Eigenschaften des SQL Server Native Client OLE DB-Anbieters 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

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter gibt DB_E_BADBOOKMARK zurück, wenn der Consumer beim Positionieren oder Suchen eines mit einem Lesezeichen versehenen Rowsets ein gültiges Lesezeichen angibt.

DBPROP_BOOKMARKTYPE

R/W: Schreibgeschützt

Standard: DBPROPVAL_BMK_NUMERIC

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter implementiert nur numerische Lesezeichen. Ein SQL Server Native Client OLE DB-Anbieter-Lesezeichen ist eine 32-Bit-Ganzzahl ohne Vorzeichen vom Typ DBTYPE_UI4.

DBPROP_CACHEDEFERRED

Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt das Rückwärts-Scrollen und -Abrufen in nicht sequenziellen Rowsets. Der SQL Server Native Client OLE DB-Anbieter 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

Standard: VARIANT_FALSE

Beschreibung: Standardmäßig gibt der SQL Server Native Client OLE DB-Anbieter DB_E_ROWSNOTRELEASED zurück, wenn der Consumer versucht, mehr Zeilen für ein Rowset abzurufen, während für die derzeit 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 SQL Server Native Client OLE DB-Anbieters, die Lesezeichen enthalten, werden von SQL Server-Cursorn unterstützt.

DBPROP_CHANGEINSERTEDROWS

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Diese Eigenschaft kann nur auf VARIANT_TRUE festgelegt werden, wenn das Rowset einen keysetgesteuerten Cursor verwendet.

DBPROP_COLUMNRESTRICT

R/W: Schreibgeschützt

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter 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

Standard: 0

Beschreibung: Standardmäßig führt der SQL Server Native Client OLE DB-Anbieter kein Timeout für die ICommand::Execute-Methode aus.

DBPROP_COMMITPRESERVE

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

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

VARIANT_TRUE: Der SQL Server Native Client OLE DB-Anbieter behält ein gültiges Rowset bei.

VARIANT_FALSE: Der SQL Server Native Client OLE DB-Anbieter macht nach einem Commitvorgang Rowsets 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

Standard: VARIANT_FALSE

Beschreibung: Wenn der SQL Server Native Client OLE DB-Anbieter auf VARIANT_TRUE festgelegt ist, versucht er, 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

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt den Sofortaktualisierungsmodus für Speicherobjekte.

An Daten in einem sequenziellen Streamobjekt 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

Standard: VARIANT_FALSE

Beschreibung: Anzahl der ausgeblendeten 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

Standard: VARIANT_TRUE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt diese Schnittstellen für alle Rowsets.

DBPROP_IColumnsRowset

R/W: Lesen/Schreiben

Standard: VARIANT_TRUE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die Schnittstelle IColumnsRowset.

DBPROP_IConnectionPointContainer

R/W: Lesen/Schreiben

Standard: 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 ICommandProperties::SetProperties anzufordern.

DBPROP_IMultipleResults

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die Schnittstelle IMultipleResults.

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die Schnittstellen IRowsetChange und IRowsetUpdate.

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

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 SQL Server Native Client OLE DB-Anbieter 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

Standard: VARIANT_TRUE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt die Schnittstelle IRowsetIdentity. 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 die gleiche Zeileninstanz verweisen.

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter legt DBPROP_BOOKMARKS und DBPROP_LITERALBOOKMARKS auf VARIANT_TRUE fest, wenn der Consumer eine der beiden Schnittstellen anfordert.

Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieters 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

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die Schnittstelle IRowsetResynch bei Bedarf verfügbar. Der SQL Server Native Client OLE DB-Anbieter kann die Schnittstelle für ein beliebiges Rowset verfügbar machen.

DBPROP_ISupportErrorInfo

R/W: Lesen/Schreiben

Standard: VARIANT_TRUE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die Schnittstelle ISupportErrorInfo für Rowsets verfügbar.

DBPROP_ILockBytes

Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_ISequentialStream

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter macht die Schnittstelle ISequentialStream verfügbar, um Long-Daten mit variabler Länge zu unterstützen, die in SQL Server gespeichert sind.

DBPROP_IStorage

Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_IStream

Diese Schnittstelle wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_IMMOBILEROWS

R/W: Lesen/Schreiben

Standard: 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

Standard: VARIANT_TRUE

Beschreibung: Diese Eigenschaft weist immer den Wert VARIANT_TRUE auf.

DBPROP_LOCKMODE

R/W: Lesen/Schreiben

Standard: DBPROPVAL_LM_NONE

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

HinweisHinweis
Beim Verwenden der Snapshotisolation 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

Standard: 0

Beschreibung: Die Anzahl der Zeilen, die in Rowsets aktiv sein können, wird nicht vom SQL Server Native Client OLE DB-Anbieter eingeschränkt.

DBPROP_MAXPENDINGROWS

R/W: Schreibgeschützt

Standard: 0

Beschreibung: Die Anzahl der Rowsetzeilen, für die Änderungen ausstehen, wird nicht vom SQL Server Native Client OLE DB-Anbieter eingeschränkt.

DBPROP_MAXROWS

R/W: Lesen/Schreiben

Standard: 0

Beschreibung: Standardmäßig wird die Anzahl der Zeilen in einem Rowset nicht vom SQL Server Native Client OLE DB-Anbieter eingeschränkt. Wenn der Consumer DBPROP_MAXROWS festlegt, verwendet der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_MEMORYUSAGE

Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_NOTIFICATIONGRANULARITY

Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieters können abgebrochen werden, bevor ein Versuch unternommen wird, die angegebene Änderung des Rowsets vorzunehmen. Der SQL Server Native Client OLE DB-Anbieter unterstützt keinen Phasenabbruch, nachdem der Versuch abgeschlossen wurde.

DBPROP_ORDEREDBOOKMARKS

Diese Rowseteigenschaft wird nicht vom SQL Server Native Client OLE DB-Anbieter 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

Standard: VARIANT_FALSE

Beschreibung: Das Festlegen von Eigenschaften zum Ändern der Sichtbarkeit führt dazu, dass der SQL Server Native Client OLE DB-Anbieter 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

Standard: VARIANT_FALSE

Beschreibung: Wenn der SQL Server Native Client OLE DB-Anbieter auf VARIANT_TRUE festgelegt ist, versucht er, einen Servercursor für das Rowset zu verwenden.

DBPROP_REENTRANTEVENTS

R/W: Schreibgeschützt

Standard: VARIANT_TRUE

Beschreibung: Die Rowsets des SQL Server Native Client OLE DB-Anbieters 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

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter ändert den Wert der Eigenschaft basierend auf der Sichtbarkeit von Änderungen an den 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 ist VARIANT_TRUE.

VARIANT_FALSE: Zeilen, die vom Consumer oder anderen SQL Server-Benutzern gelöscht werden, werden beim Aktualisieren eines Rowsets nicht aus dem Rowset 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 SQL Server Native Client OLE DB-Anbieter implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert.

DBPROP_RETURNPENDINGINSERTS

R/W: Schreibgeschützt

Standard: VARIANT_FALSE

Beschreibung: Wenn eine Methode zum Abrufen von Zeilen aufgerufen wird, gibt der SQL Server Native Client OLE DB-Anbieter keine ausstehenden Einfügezeilen zurück.

DBPROP_ROWRESTRICT

R/W: Schreibgeschützt

Standard: VARIANT_TRUE

Beschreibung: Die Rowsets des SQL Server Native Client OLE DB-Anbieters unterstützen keine auf der Zeile basierenden Zugriffsrechte. Wenn die Schnittstelle IRowsetChange für ein Rowset verfügbar gemacht wird, kann die SetData-Methode vom Consumer aufgerufen werden.

DBPROP_ROWSET_ASYNCH

R/W: Lesen/Schreiben

Standard: 0

Beschreibung: 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 vom SQL Server Native Client unterstützte Wert in der Bitmaske ist DBPROPVAL_ASYNCH_INITIALIZE.

DBPROP_ROWTHREADMODEL

R/W: Schreibgeschützt

Standard: DBPROPVAL_RT_FREETHREAD

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt den Zugriff auf seine Objekte von mehreren Ausführungsthreads eines einzelnen Consumers aus.

DBPROP_SERVERCURSOR

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Wenn 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

Standard: 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 Cache für die lokale Zeile zu aktualisieren.

VARIANT_FALSE: Der Anbieter ruft keine Serverwerte für neu eingefügte Zeilen ab.

DBPROP_STRONGIDENTITY

R/W: Schreibgeschützt

Standard: 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

Standard: VARIANT_FALSE

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter unterstützt nur transaktive Objekte. Weitere Informationen finden Sie unter Transaktionen.

DBPROP_UNIQUEROWS

R/W: Lesen/Schreiben

Standard: VARIANT_FALSE

Beschreibung: Eindeutige Zeilen.

VARIANT_TRUE: Jede Zeile wird eindeutig von ihren Spaltenwerten identifiziert. Die Guppe 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 entweder von ihren Spaltenwerten eindeutig identifiziert oder nicht. Die Schlüsselspalten sind möglicherweise mit DBCOLUMNFLAGS_KEYCOLUMN gekennzeichnet.

DBPROP_UPDATABILITY

R/W: Lesen/Schreiben

Standard: 0

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter 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 SQL Server Native Client OLE DB-Anbieter 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

Standard: VT_EMPTY

Beschreibung: Ein Array von ganzzahligen Werten, die die Ordnungsposition (1-basiert) der Ergebnisspalte einer COMPUTE-Klausel innerhalb der aktuellen Transact-SQL SELECT-Anweisung darstellen. Dies ist die SQL Server Native Client OLE DB-Anbieter-Entsprechung des ODBC SQL_CA_SS_COLUMN_ID-Attributs.

SSPROP_COMPUTE_BYLIST

Spalte: ComputeByList

R/W: Schreibgeschützt

Typ: VT_BOOL

Standard: VARIANT_FALSE

Beschreibung: Ein boolescher Wert, der angibt, dass die Spalte Teil des COMPUTE BY-Resultsets ist. Dies ist die SQL Server Native Client OLE DB-Anbieter-Entsprechung des ODBC SQL_CA_SS_COMPUTE_BYLIST-Attributs.

HinweisHinweis
Die OLE DB-Eigenschaft ist ein boolescher Wert, während das ODBC-Attribut eine Liste von kurzen Werten ohne Vorzeichen mit allen Spaltenordnungszahlen einer BY-Klausel darstellt.

VARIANT_TRUE: Die Spalte stammt von einer COMPUTE BY-Anweisung.

VARIANT_FALSE: Die Spalte ist eine reguläre Spalte; sie stammt nicht von der COMPUTE BY-Anweisung.

SSPROP_COMPUTE_ID

Spalte: ComputeID

R/W: Schreibgeschützt

Typ: VT_U12

Standard: 0

Beschreibung: Die ComputeID einer Zeile, die das Ergebnis einer COMPUTE-Klausel in der aktuellen Transact-SQL SELECT-Anweisung ist. Dies ist die SQL Server Native Client OLE DB-Anbieter-Entsprechung des ODBC SQL_CA_SS_COMPUTE_ID-Attributs.

SSPROP_DEFERPREPARE

Spalte: No

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standard: 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: No

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standard: 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: No.

R/W: Lesen/Schreiben

Typ: VT_BOOL

Standard: VARIANT_FALSE

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

SSPROP_MAXBLOBLENGTH

Spalte: No

R/W: Lesen/Schreiben

Typ: VT_I4

Standard: Der Anbieter schränkt die Größe des vom Server zurückgegebenen Texts nicht ein, und der Eigenschaftswert wird auf das Maximum festgelegt. Beispiel: 2147483647.

Beschreibung: Der SQL Server Native Client OLE DB-Anbieter führt eine SET TEXTSIZE-Anweisung aus, um die Länge der BLOB (Binary Large Object)-Daten zu begrenzen, die in einer SELECT-Anweisung zurückgegeben werden.

SSPROP_NOCOUNT_STATUS

Spalte: NoCount

R/W: Schreibgeschützt

Typ: VT_BOOL

Standard: 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: No

R/W: Lesen/Schreiben

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

Standard: leere Zeichenfolge

Beschreibung: Der Nachrichtentext der Abfragebenachrichtigung. Dieser ist benutzerdefiniert und weist kein bestimmtes Format auf.

SSPROP_QP_NOTIFICATION_OPTIONS

Spalte: No

R/W: Lesen/Schreiben

Typ: VT_BSTR

Standard: 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>|broker instance=<broker instance>)]

Beispiel:

service=mySSBService;local database=mydb

SSPROP_QP_NOTIFICATION_TIMEOUT

Spalte: No

R/W: Lesen/Schreiben

Typ: VT_UI4

Standard: 432000 Sekunden (5 Tage).

Minimum: 1 Sekunde

Maximum: 2^31-1 Sekunden

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

Änderungsverlauf

Aktualisierter Inhalt

Die Beschreibung für DBPROP_ROWSET_ASYNCH wurde aktualisiert.

Siehe auch

Konzepte