Rowset-Eigenschaften und -Verhalten (Nativer Client OLE DB-Anbieter)
Gilt für: SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Dies sind die OLE DB-Anbieter-Rowseteigenschaften des SQL Server Native Client.
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-Anbieter des SQL Server Native Client ungültige Rowsets nach einem Abgebrochenen Vorgang. 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-Anbieter des SQL Server Native Client verwaltet ein gültiges Rowset. |
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 Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
DBPROP_BLOCKINGSTORAGEOBJECTS | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Der OLE DB-Speicherobjektblock des SQL Server Native Client-Anbieters verwendet andere Rowset-Methoden. |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client unterstützt Lesezeichen für die Zeilenidentifikation, wenn DBPROP_BOOKMARKS oder DBPROP_LITERALBOOKMARKS VARIANT_TRUE ist. 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-Anbieter von SQL Server Native Client verwendet einen Microsoft SQL Server-Cursor, um ein Rowset zu unterstützen, das Textmarken enthält. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. Hinweis: Das Festlegen dieser Eigenschaften im Konflikt mit anderen OLE DB-Eigenschaften des SQL Server Native Client OLE DB-Anbieters verursacht einen Fehler. 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 OLE DB-Anbieter von SQL Server Native Client gibt DB_E_BADBOOKMARK zurück, wenn der Consumer eine ungültige Textmarke angibt, wenn ein lesezeicheniertes Rowset positioniert oder durchsucht wird. |
DBPROP_BOOKMARKTYPE | R/W: Schreibgeschützt Standardwert: DBPROPVAL_BMK_NUMERIC Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client implementiert nur numerische Lesezeichen. Eine TEXTMARKE des OLE DB-Anbieters von SQL Server Native Client ist eine 32-Bit-Ganzzahl ohne Vorzeichen, geben Sie DBTYPE_UI4 ein. |
DBPROP_CACHEDEFERRED | Diese Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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-Anbieter von SQL Server Native Client unterstützt das Rückwärtsholen und Scrollen in nichtsequentialen Rowsets. Der OLE DB-Anbieter von SQL Server Native Client erstellt ein cursorgestütztes Rowset, wenn entweder DBPROP_CANFETCHBACKWARDS oder DBPROP_CANSCROLLBACKWARDS VARIANT_TRUE ist. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. |
DBPROP_CANHOLDROWS | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Standardmäßig gibt der OLE DB-Anbieter des SQL Server Native Client DB_E_ROWSNOTRELEASED zurück, wenn der Consumer versucht, weitere Zeilen für ein Rowset abzurufen, während ausstehende Änderungen für die aktuell im Rowset vorhanden sind. 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. SQL Server Native Client OLE DB-Anbieter-Rowsets, die Textmarken 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 Standard: VARIANT_FALSE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client 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: Standardmäßig wird beim OLE DB-Anbieter des SQL Server Native Client kein Timeout für die Methode "ICommand::Execute" ausgeführt. |
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-Anbieter des SQL Server Native Client verwaltet ein gültiges Rowset. VARIANT_FALSE: Der OLE DB-Anbieter des SQL Server Native Client ungültige Rowsets nach einem Commit-Vorgang. 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: Beim Festlegen auf VARIANT_TRUE versucht der OLE DB-Anbieter des SQL Server Native Client, 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 OLE DB-Anbieter von SQL Server Native Client unterstützt den sofortigen Updatemodus 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-Anbieter des SQL Server Native Client unterstützt diese Schnittstellen für alle Rowsets. |
DBPROP_IColumnsRowset | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client 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-Anbieter des SQL Server Native Client unterstützt die IMultipleResults-Schnittstelle . |
DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client unterstützt die IRowsetChange - und IRowsetUpdate-Schnittstellen . 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-Anbieter von SQL Server Native Client verwendet einen SQL Server-Cursor, um Rowsets zu unterstützen, 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-Anbieter von SQL Server Native Client 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-Anbieter von SQL Server Native Client kann die IRowsetLocate - und IRowsetScroll-Schnittstellen 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-Anbieter von SQL Server Native Client legt DBPROP_BOOKMARKS fest und DBPROP_LITERALBOOKMARKS auf VARIANT_TRUE, wenn die Consumerschnittstelle anfordert. Der OLE DB-Anbieter von SQL Server Native Client verwendet SQL Server-Cursor, um IRowsetLocate und IRowsetScroll zu unterstützen. Weitere Informationen finden Sie unter Rowsets und SQL Server-Cursor. Das Festlegen dieser Eigenschaften in Konflikt mit anderen OLE DB-Anbietereigenschaften des SQL Server Native Client führt zu einem Fehler. 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-Anbieter des SQL Server Native Client macht die IRowsetResynch-Schnittstelle bei Bedarf verfügbar. Der OLE DB-Anbieter von SQL Server Native Client kann die Schnittstelle für jedes Rowset verfügbar machen. |
DBPROP_ISupportErrorInfo | R/W: Lesen/Schreiben Standardwert: VARIANT_TRUE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client macht die ISupportErrorInfo-Schnittstelle für Rowsets verfügbar. |
DBPROP_ILockBytes | Diese Schnittstelle wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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-Anbieter von SQL Server Native Client macht die ISequentialStream-Schnittstelle verfügbar, um lange, in SQL Server gespeicherte Daten mit variabler Länge zu unterstützen. |
DBPROP_IStorage | Diese Schnittstelle wird nicht vom OLE DB-Anbieter des SQL Server Native Client implementiert. Beim Versuch, die Eigenschaft zu lesen oder zu schreiben, wird ein Fehler generiert. |
DBPROP_IStream | Diese Schnittstelle wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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: Der OLE DB-Anbieter von SQL Server Native Client beschränkt nicht die Anzahl der Zeilen, die in Rowsets aktiv sein können. |
DBPROP_MAXPENDINGROWS | R/W: Schreibgeschützt Standardwert: 0 Beschreibung: Der OLE DB-Anbieter des SQL Server Native Client beschränkt nicht die Anzahl der Rowsetzeilen mit ausstehenden Änderungen. |
DBPROP_MAXROWS | R/W: Lesen/Schreiben Standardwert: 0 Beschreibung: Standardmäßig beschränkt der OLE DB-Anbieter des SQL Server Native Client nicht die Anzahl von Zeilen in einem Rowset. Wenn der Consumer DBPROP_MAXROWS festlegt, verwendet der OLE DB-Anbieter von SQL Server Native Client die SET ROWCOUNT-Anweisung, um die Anzahl der Zeilen im Rowset zu begrenzen. 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 Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
DBPROP_MEMORYUSAGE | Diese Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client implementiert. Beim Versuch, den Eigenschaftswert zu lesen oder zu schreiben, wird ein Fehler generiert. |
DBPROP_NOTIFICATIONGRANULARITY | Diese Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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-Anbieter des SQL Server Native Client 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 versucht wird, die angegebene Rowsetänderung auszuführen. Der OLE DB-Anbieter des SQL Server Native Client unterstützt den Phasenabbruch nach Abschluss des Versuchs nicht. |
DBPROP_ORDEREDBOOKMARKS | Diese Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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 Sichtbarkeitseigenschaften für Änderungen bewirkt, dass der OLE DB-Anbieter des SQL Server Native Client SQL Server-Cursor verwendet, um das Rowset zu unterstützen. 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-Anbieter des SQL Server Native Client, einen Servercursor für das Rowset zu verwenden. |
DBPROP_REENTRANTEVENTS | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: Die OLE DB-Anbieter-Rowsets von SQL Server Native Client sind neu einsteigert und können DB_E_NOTREENTRANT zurückgeben, wenn ein Consumer versucht, über einen Benachrichtigungsrückruf auf eine Nicht-Teilnehmer-Rowset-Methode zuzugreifen. |
DBPROP_REMOVEDELETED | R/W: Lesen/Schreiben Standardwert: VARIANT_FALSE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client ä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 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 Rowset-Eigenschaft wird nicht vom OLE DB-Anbieter des SQL Server Native Client 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, die Zeilen abruft, aufgerufen wird, gibt der OLE DB-Anbieter des SQL Server Native Client keine ausstehenden Einfügezeilen zurück. |
DBPROP_ROWRESTRICT | R/W: Schreibgeschützt Standardwert: VARIANT_TRUE Beschreibung: SQL Server Native Client OLE DB-Anbieter-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, die von SQL Server Native Client unterstützt wird, ist DBPROPVAL_ASYNCH_INITIALIZE. |
DBPROP_ROWTHREADMODEL | R/W: Schreibgeschützt Standardwert: DBPROPVAL_RT_FREETHREAD Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client unterstützt den Zugriff auf seine Objekte aus mehreren Ausführungsthreads eines einzelnen Consumers. |
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 Standard: VARIANT_FALSE Beschreibung: Der OLE DB-Anbieter von SQL Server Native Client unterstützt nur Transacted-Objekte. 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-Anbieter von SQL Server Native Client 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-Anbieter von SQL Server Native Client 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 das SQL Server Native Client OLE DB-Anbieteräquivalent 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_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-Anbieter von SQL Server Native Client führt eine SET TEXTSIZE-Anweisung aus, um die Länge der in einer SELECT-Anweisung zurückgegebenen BLOB-Daten (Binary Large Object) einzuschränken. |
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. |