Eigenschaften und Verhaltensweisen von Rowsets
Gilt für: 
SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
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>|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. |