資料列集屬性 (OLE DB)

DBPROPSET_ROWSET 屬性集含有下列屬性。這些屬性都屬於「資料列集」屬性群組。DBPROPSET_SSCE_ROWSET 中定義額外的屬性。

屬性識別碼

說明

DBPROP_ABORTPRESERVE

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:在中止上保留

  • 附註:對於此提供者,其值永遠是 VARIANT_FALSE。這指出,在中止交易之後,資料列集唯一允許的作業,是釋放資料列與存取子控制代碼,以及釋放資料列集。

DBPROP_ACCESSORDER

  • 類型:VT_I4

  • 讀取/寫入:唯讀

  • 描述:存取順序

  • 附註:對於此提供者,其值永遠是 DBPROPVAL_AO_RANDOM。

DBPROP_BLOCKINGSTORAGEOBJECTS

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:區塊儲存物件

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。

DBPROP_BOOKMARKS

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:使用書籤

  • 附註:指定資料列集是否支援書籤。此提供者支援下列的值:

    • VARIANT_TRUE,表示資料列集支援書籤。Column 0 是資料列的書籤。取得此資料列就會取得書籤值。這可以用來重新定位到資料列。

    • VARIANT_FALSE,表示資料列集不支援書籤。資料列集會循序排列,並且會忽略 DBPROP_LITERALBOOKMARKS 與 DBPROP_ORDEREDBOOKMARKS 屬性值。

DBPROP_BOOKMARKTYPE

  • 類型:VT_UI4

  • 一般讀取/寫入:唯讀

  • 描述:書籤型別

  • 附註:指定資料列集支援的書籤型別。對於此提供者,其值永遠是 DBPROPVAL_BMK_NUMERIC。這表示書籤型別屬於數值。數值書籤會根據資料列的屬性,而不會根據資料列的資料行值。例如,數值書籤可能會根據資料列在資料列集內部的絕對位置,或是根據資料列建立時儲存引擎指派給資料列的資料列識別碼。修改資料列的資料行不會變更數值書籤的有效性。

    書籤屬於 DBTYPE_UI4 型別。在 SQL Server Compact 3.5 之前的版本中,書籤屬於 DBTYPE_I4 型別。

DBPROP_CANFETCHBACKWARDS

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:向後擷取

  • 附註:指定資料列集是否可以向後擷取。此提供者支援下列的值:

    • VARIANT_TRUE,表示 IRowset::GetNextRows 中的 cRows 可以是負值。當它是負值時,此方法會從指定的資料列向後擷取資料列。

    • VARIANT_FALSE,表示 cRows 不能是負值。

DBPROP_CANHOLDROWS

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取

  • 描述:保留資料列

  • 附註:對於此提供者,此屬性永遠是 VARIANT_FALSE。

DBPROP_CANSCROLLBACKWARDS

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取

  • 描述:向後捲動

  • 附註:對於此提供者,此屬性永遠是 VARIANT_FALSE。這表示 IRowsOffset 不能是負值。

DBPROP_CHANGEINSERTEDROWS

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取

  • 描述:變更插入的資料列

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。這表示,取用者可以對新插入的資料列呼叫 IRowsetChange::DeleteRows 或 IRowsetChange::SetData。新插入的資料列是定義為已傳送到資料儲存的插入資料列,而不是暫止插入的資料列。

DBPROP_COMMITPRESERVE

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:在認可上保留

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。這表示,在保留的認可之後,此資料列集維持作用中。也就是說,您可以提取新資料列、更新、刪除、插入資料列等等。

DBPROP_DEFERRED

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:延遲資料行

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。這表示,在此資料行上使用存取子之後,才會提取資料行中的資料。

DBPROP_DELAYSTORAGEOBJECTS

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:延遲儲存物件更新

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。這表示,儲存物件也會用於延遲的更新模式。

DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetChange

DBPROP_IRowsetInfo

DBPROP_IRowsetUpdate

DBPROP_ISupportErrorInfo

DBPROP_IRowsetIndex

DBPROP_IRowsetCurrentIndex

DBPROP_IRowsetBookmark

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入,但是下列所述除外。

  • 附註:如果將這類屬性任何一個的值設為 VARIANT_TRUE,則此資料列集就支援指定的介面。這些屬性主要是用來透過 ICommandProperties::SetProperties 要求介面。下列屬性為唯讀,並且永遠是 VARIANT_TRUE:

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    將 DBPROP_IRowsetUpdate 設定為 VARIANT_TRUE,會自動將 DBPROP_IRowsetChange 設定為 VARIANT_TRUE。將 DBPROP_IRowsetCurrentIndex 設定為 VARIANT_TRUE,會自動將 DBPROP_IRowsetIndex 設定為 VARIANT_TRUE。

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 附註:如果將此屬性的值設定為 VARIANT_TRUE,則指定的資料行會被視為顯示指定介面的儲存物件。

DBPROP_IMMOBILEROWS

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:固定的資料列

  • 附註:對於此提供者,其值永遠是 VARIANT_FALSE。這表示,如果資料列集已經過排序,插入的資料列與更新的資料列 (排序準則中的一個或多個資料行已經過更新) 就會按照資料列集的排序準則。如果資料列集未經過排序,則無法保證插入的資料列會出現在確定的位置,而且已更新資料列的位置也不會變更。此屬性只有在 DBPROP_OWNINSERT 設為 VARIANT_TRUE 時才有意義。

DBPROP_LOCKMODE

  • 類型:VT_I4

  • 讀取/寫入:讀取

  • 描述:鎖定模式

  • 附註:對於此提供者,其值永遠是 DBPROPVAL_LM_SINGLEROW。

DBPROP_MAXOPENROWS

  • 類型:VT_I4

  • 一般讀取/寫入:讀取

  • 描述:開啟資料列的上限

  • 附註:對於 SQL Server Compact 3.5,此值為 1。

DBPROP_MAXROWS

  • 類型:VT_I4

  • 一般讀取/寫入:唯讀

  • 描述:資料列的上限

  • 附註:指定一個資料列集可以傳回的資料列最大數目。如果沒有限制,此值為 0。對於這個提供者而言,此值永遠為 0。

DBPROP_OTHERINSERT

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:其他插入。

  • 附註:基底資料表為 True;其他則為 False。

DBPROP_OTHERUPDATEDELETE

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:可見的其他變更

  • 附註:指定下列其中一個值:

    • VARIANT_TRUE,表示資料列集可以看見不是此資料列集取用者的使用者所進行的更新與刪除。例如,假設有一位使用者不是資料列集的取用者,此使用者更新某資料列所含的資料,或者刪除資料列。如果將資料列完全釋放,此資料列集的任何取用者在下次提取此資料列時,就會看見該項變更。這包括他人在相同交易中進行的更新與刪除,以及在此交易之外的人所進行的更新與刪除。交易隔離等級不會影響資料列集看見他人在相同交易中所進行之更新或刪除的能力,例如,相同工作階段中的其他資料列集。然而,這的確會限制資料列集看見在交易之外的人所進行之更新或刪除的能力。

    • VARIANT_FALSE,表示資料列集無法看見他人所進行的更新與刪除。

DBPROP_OWNINSERT

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:可見的自我插入

DBPROP_OWNUPDATEDELETE

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:可見的自我變更

DBPROP_QUICKRESTART

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取/寫入

  • 描述:快速重新啟動

DBPROP_REMOVEDELETED

  • 類型:VT_BOOL

  • 一般讀取/寫入:讀取

  • 描述:移除刪除的資料列

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。

DBPROP_REPORTMULTIPLECHANGES

  • 類型:VT_BOOL

  • 一般讀取/寫入:唯讀

  • 描述:報表多重變更

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。

DBPROP_ROWTHREADMODEL

  • 類型:VT_I4

  • 一般讀取/寫入:唯讀

  • 描述:資料列執行緒模式指定此命令產生的資料列集之執行緒模式。對於此提供者,其值永遠是 DBPROPVAL_RT_SINGLETHREAD。

DBPROP_SERVERDATAONINSERT

  • 類型:VT_BOOL

  • 讀取/寫入:讀取

  • 描述:插入的伺服器資料

  • 附註:對於此提供者,其值永遠是 VARIANT_TRUE。

DBPROP_UPDATABILITY

  • 類型:VT_I4

  • 一般讀取/寫入:讀取/寫入

  • 描述:可更新性