Freigeben über


Rowset-Eigenschaften (OLE DB)

Der DBPROPSET_ROWSET-Eigenschaftensatz enthält die folgenden Eigenschaften. Diese Eigenschaften gehören alle zur Rowset-Eigenschaftengruppe. Weitere Eigenschaften sind in DBPROPSET_SSCE_ROWSET definiert.

Eigenschafts-ID

Beschreibung

DBPROP_ABORTPRESERVE

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Bei Abbruch erhalten

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_FALSE. Dies gibt an, dass für ein Rowset, nachdem eine Transaktion abgebrochen wurde, nur folgende Vorgänge zulässig sind: Freigeben von Zeilenhandles, Freigeben von Accessorhandles und Freigeben des Rowsets.

DBPROP_ACCESSORDER

  • Typ: VT_I4

  • Lesen/Schreiben: Nur Lesen

  • Beschreibung: Zugriffsreihenfolge

  • Hinweis: Der Wert für diesen Anbieter ist immer DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Speicherobjekte blockieren

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE.

DBPROP_BOOKMARKS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Lesezeichen verwenden

  • Hinweis: Gibt an, ob das Rowset Lesezeichen unterstützt. Der Anbieter unterstützt die folgenden Werte:

    • VARIANT_TRUE gibt an, dass das Rowset Lesezeichen unterstützt. Spalte 0 ist das Lesezeichen für die Zeilen. Ein Abrufen dieser Spalte führt zu einem Lesezeichenwert. Mit diesem Wert kann eine Neupositionierung in der Zeile durchgeführt werden.

    • VARIANT_FALSE gibt an, dass das Rowset keine Lesezeichen unterstützt. Das Rowset ist sequenziell, und die Werte der Eigenschaften DBPROP_LITERALBOOKMARKS und DBPROP_ORDEREDBOOKMARKS werden ignoriert.

DBPROP_BOOKMARKTYPE

  • Typ: VT_UI4

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Lesezeichentyp

  • Hinweise: Gibt den Lesezeichentyp an, den das Rowset unterstützt. Der Wert für diesen Anbieter ist immer DBPROPVAL_BMK_NUMERIC. Dies gibt an, dass das Lesezeichen einen numerischen Typ hat. Numerische Lesezeichen basieren auf den Eigenschaften einer Zeile und hängen nicht von den Werten der Spalten der Zeile ab. Ein numerisches Lesezeichen kann beispielsweise auf der absoluten Position basieren, die die Zeile im Rowset hat, oder auf einer Zeilen-ID, die das Speichermodul einer Zeile zugewiesen hat, als diese erstellt wurde. Ein Ändern der Spalten einer Zeile wirkt sich nicht auf die Gültigkeit numerischer Lesezeichen aus.

    Lesezeichen haben den Typ DBTYPE_UI4. In früheren Versionen von SQL Server Compact 3.5 hatten Lesezeichen den Typ DBTYPE_I4.

DBPROP_CANFETCHBACKWARDS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Rückwärts abrufen

  • Hinweis: Gibt an, ob das Rowset rückwärts abrufen kann. Der Anbieter unterstützt die folgenden Werte:

    • VARIANT_TRUE gibt an, dass cRows in IRowset::GetNextRows negativ sein darf. Ist der Wert negativ, ruft diese Methode Zeilen ab der angegebenen Zeile rückwärts ab.

    • VARIANT_FALSE gibt an, dass cRows nicht negativ sein darf.

DBPROP_CANHOLDROWS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Zeilen halten

  • Hinweis: Der Wert dieser Eigenschaft ist für diesen Anbieter immer VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Rückwärts durchlaufen

  • Hinweis: Der Wert dieser Eigenschaft ist für diesen Anbieter immer VARIANT_FALSE. Dies gibt an, dass IRowsOffset nicht negativ werden darf.

DBPROP_CHANGEINSERTEDROWS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Eingefügte Zeilen ändern

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE. Dies gibt an, dass der Consumer für neu eingefügte Zeilen IRowsetChange::DeleteRows oder IRowsetChange::SetData aufrufen kann. Eine neu eingefügte Zeile ist als eine Zeile definiert, für die die Einfügung an den Datenspeicher übertragen wurde (statt einer ausstehenden Einfügezeile).

DBPROP_COMMITPRESERVE

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Bei Commit beibehalten

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE. Dies zeigt an, dass das Rowset nach einem beibehaltenden Commit aktiv bleibt. Das heißt, dass Sie neue Zeilen abrufen sowie Zeilen aktualisieren, löschen und einfügen können usw.

DBPROP_DEFERRED

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Spalte zurückstellen

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE. Dies zeigt an, dass die Daten so lange nicht aus der Spalte abgerufen werden, bis für die Spalte ein Accessor verwendet wird.

DBPROP_DELAYSTORAGEOBJECTS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Speicherobjektaktualisierungen verzögern

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE. Dies zeigt an, dass Speicherobjekte auch im verzögerten Aktualisierungsmodus verwendet werden.

DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetChange

DBPROP_IRowsetInfo

DBPROP_IRowsetUpdate

DBPROP_ISupportErrorInfo

DBPROP_IRowsetIndex

DBPROP_IRowsetCurrentIndex

DBPROP_IRowsetBookmark

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben mit den nachstehend aufgeführten Ausnahmen

  • Hinweise: Ist der Wert einer dieser Eigenschaften auf VARIANT_TRUE festgelegt, unterstützt das Rowset die angegebene Schnittstelle. Diese Eigenschaften werden hauptsächlich dazu verwendet, die jeweiligen Schnittstellen über ICommandProperties::SetProperties anzufordern. Die folgenden Eigenschaften sind schreibgeschützt und immer auf VARIANT_TRUE festgelegt:

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    Wird DBPROP_IRowsetUpdate auf VARIANT_TRUE festgelegt, wird DBPROP_IRowsetChange automatisch auf VARIANT_TRUE festgelegt. Wird DBPROP_IRowsetCurrentIndex auf VARIANT_TRUE festgelegt, wird DBPROP_IRowsetIndex automatisch auf VARIANT_TRUE festgelegt.

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Hinweis: Wenn diese Eigenschaft auf VARIANT_TRUE festgelegt ist, wird die angegebene Spalte als ein Speicherobjekt behandelt, das die angegebene Schnittstelle offen legt.

DBPROP_IMMOBILEROWS

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Nicht mobile Zeilen

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_FALSE. Wenn das Rowset sortiert ist, zeigt dies an, dass für eingefügte Zeilen und aktualisierte Zeilen (in denen mindestens eine der Spalten, die zu den Sortierkriterien gehören, aktualisiert wurde) die Sortierkriterien des Rowsets beachtet werden. Wenn das Rowset nicht sortiert ist, kann nicht sichergestellt werden, dass eingefügte Zeilen eine genau festgelegte Position einnehmen, und wird die Position aktualisierter Zeilen nicht geändert. Diese Eigenschaft ist nur dann sinnvoll, wenn DBPROP_OWNINSERT auf VARIANT_TRUE festgelegt ist.

DBPROP_LOCKMODE

  • Typ: VT_I4

  • Lesen/Schreiben: Lesen

  • Beschreibung: Sperrmodus

  • Hinweis: Der Wert für diesen Anbieter ist immer DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Typ: VT_I4

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Maximale Anzahl geöffneter Zeilen

  • Hinweis: Für SQL Server Compact 3.5 hat diese Eigenschaft den Wert 1.

DBPROP_MAXROWS

  • Typ: VT_I4

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Maximale Anzahl Zeilen

  • Hinweise: Gibt die maximale Anzahl von Zeilen an, die in einem Rowset zurückgegeben werden können. Beim Wert 0 ist die Anzahl nicht beschränkt. Bei diesem Anbieter ist der Wert immer 0.

DBPROP_OTHERINSERT

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Einfügungen anderer sichtbar

  • Hinweise: Für Basistabellen hat die Eigenschaft den Wert TRUE; für andere Tabellen hat sie den Wert FALSE.

DBPROP_OTHERUPDATEDELETE

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Änderungen anderer sichtbar

  • Hinweise: Gibt einen der folgenden Werte an:

    • VARIANT_TRUE zeigt an, dass das Rowset Aktualisierungen und Löschungen sehen kann, die ein Benutzer vorgenommen hat, der kein Consumer des Rowsets ist. Nehmen Sie beispielsweise an, ein Benutzer, der kein Consumer des Rowsets ist, aktualisiert die Daten, die einer Zeile zugrunde liegen, oder löscht die Zeile. Ist die Zeile vollständig freigegeben, sieht jeder Consumer des Rowsets die Änderung, nachdem er die Zeile das nächste Mal abgerufen hat. Dies beinhaltet sowohl Änderungen und Löschungen, die von anderen in derselben Transaktion, als auch Änderungen und Löschungen, die von anderen außerhalb der Transaktion vorgenommen wurden. Die Transaktionsisolationsstufe hat keinen Einfluss darauf, dass der Rowset Aktualisierungen oder Löschungen sehen kann, die andere in derselben Transaktion vorgenommen haben (wie andere Rowsets in derselben Sitzung). Sie schränkt aber die Möglichkeit des Rowsets ein, Aktualisierungen oder Löschungen zu sehen, die andere außerhalb der Transaktion vorgenommen haben.

    • VARIANT_FALSE zeigt an, dass das Rowset Aktualisierungen und Löschungen, die von anderen vorgenommen wurden, nicht sehen kann.

DBPROP_OWNINSERT

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Eigene Einfügungen sichtbar

DBPROP_OWNUPDATEDELETE

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Eigene Änderungen sichtbar

DBPROP_QUICKRESTART

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Schneller Neustart

DBPROP_REMOVEDELETED

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Gelöschte Zeilen entfernen

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Typ: VT_BOOL

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Mehrere Änderungen melden

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

  • Typ: VT_I4

  • Typischer Wert für Lesen/Schreiben: Nur Lesen

  • Beschreibung: Zeilenthreadingmodell. Gibt das Threadingmodell der Rowsets an, die durch den Befehl generiert werden. Der Wert für diesen Anbieter ist immer DBPROPVAL_RT_SINGLETHREAD.

DBPROP_SERVERDATAONINSERT

  • Typ: VT_BOOL

  • Lesen/Schreiben: Lesen

  • Beschreibung: Serverdaten beim Einfügen

  • Hinweis: Der Wert für diesen Anbieter ist immer VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Typ: VT_I4

  • Typischer Wert für Lesen/Schreiben: Lesen/Schreiben

  • Beschreibung: Aktualisierbarkeit