共用方式為


資料列集屬性和行為

以下是 SQL Server Native Client OLE DB 提供者資料列集屬性。

屬性識別碼

描述

DBPROP_ABORTPRESERVE

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:中止操作後的資料列集行為取決於此屬性。

VARIANT_FALSE:SQL Server Native Client OLE DB 提供者會使中止操作之後的資料列集無效。資料列集物件的功能都會幾乎遺失。它僅支援 IUnknown 作業,以及未處理之資料列與存取子控制代碼的釋放。

VARIANT_TRUE:SQL Server Native Client OLE DB 提供者會維持一個有效的資料列集。

DBPROP_ACCESSORDER

R/W:讀取/寫入

預設值:DBPROPVAL_AO_RANDOM

描述:存取順序必須在資料列集上存取資料行的順序。

DBPROPVAL_AO_RANDOM:資料行可以依任何順序進行存取。

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS:當做儲存物件繫結的資料行僅能以資料行序數決定的循序順序進行存取。

DBPROPVAL_AO_SEQUENTIAL:所有資料行都必須以資料行序數決定的循序順序進行存取。

DBPROP_APPENDONLY

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_BLOCKINGSTORAGEOBJECTS

R/W:唯讀

預設值:VARIANT_TRUE

描述:使用其他資料列集方法的 SQL Server Native Client OLE DB 提供者儲存物件區塊。

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:當 DBPROP_BOOKMARKS 或 DBPROP_LITERALBOOKMARKS 為 VARIANT_TRUE 時,SQL Server Native Client OLE DB 提供者支援資料列集資料列識別的書籤。

將任一個屬性設定為 VARIANT_TRUE 不會依書籤啟用資料列集定位。將 DBPROP_IRowsetLocate 或 DBPROP_IRowsetScroll 設定為 VARIANT_TRUE 來建立支援依書籤進行資料列集定位的資料列集。

SQL Server Native Client OLE DB 提供者會使用 Microsoft SQL Server 資料指標來支援包含書籤的資料列集。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

附註附註
設定與其他 SQL Server Native Client OLE DB 提供者資料指標定義之屬性衝突的這些屬性會造成錯誤。例如,當 DBPROP_OTHERINSERT 也為 VARIANT_TRUE 時,將 DBPROP_BOOKMARKS 設定為 VARIANT_TRUE 會在取用者嘗試開啟資料列集時產生錯誤。

DBPROP_BOOKMARKSKIPPED

R/W:唯讀

預設值:VARIANT_FALSE

描述:如果取用者在定位或搜尋加上書籤的資料列集時尺出無效的書籤,SQL Server Native Client OLE DB 提供者會傳回 DB_E_BADBOOKMARK。

DBPROP_BOOKMARKTYPE

R/W:唯讀

預設值:DBPROPVAL_BMK_NUMERIC

描述:SQL Server Native Client OLE DB 提供者僅會實作數值書籤。SQL Server Native Client OLE DB 提供者書籤為 32 位元的不帶正負號整數,類型為 DBTYPE_UI4。

DBPROP_CACHEDEFERRED

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者支援在非循序的資料列集中進行反向提取和捲動。當 DBPROP_CANFETCHBACKWARDS 或 DBPROP_CANSCROLLBACKWARDS 為 VARIANT_TRUE 時,SQL Server Native Client OLE DB 提供者會建立一個資料指標支援的資料列集。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

DBPROP_CANHOLDROWS

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:根據預設,如果取用者嘗試在暫止的變更存在於目前在資料列集中的資料列時取得資料列集的其他資料列,SQL Server Native Client OLE DB 提供者會傳回 DB_E_ROWSNOTRELEASED。這個行為可以修改。

將 DBPROP_CANHOLDROWS 和 DBPROP_IRowsetChange 同時設定為 VARIANT_TRUE 意味者加上書籤的資料列集。如果兩個屬性都為 VARIANT_TRUE,在資料集上會提供 IRowsetLocate 介面,而且 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 都為 VARIANT_TRUE。

包含 SQL Server 資料指標支援之書籤的 SQL Server Native Client OLE DB 提供者資料列集。

DBPROP_CHANGEINSERTEDROWS

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:如果資料列集使用的是索引鍵集驅動資料指標,僅能將此屬性設定為 VARIANT_TRUE。

DBPROP_COLUMNRESTRICT

R/W:唯讀

預設值:VARIANT_FALSE

描述:當取用者無法變更資料列集中的資料行時,SQL Server Native Client OLE DB 提供者會將屬性設定為 VARIANT_TRUE。資料列集中的其他資料行可能可以更新,而且資料列本身可能會遭到刪除。

當屬性為 VARIANT_TRUE 時,取用者會檢查 DBCOLUMNINFO 結構的 dwFlags 成員來判斷是否可寫入個別資料行的值。對於可修改的資料行,dwFlags 會表現 DBCOLUMNFLAGS_WRITE。

DBPROP_COMMANDTIMEOUT

R/W:讀取/寫入

預設值:0

描述:根據預設,SQL Server Native Client OLE DB 提供者在 ICommand::Execute 方法上不會逾時。

DBPROP_COMMITPRESERVE

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:認可作業後的資料列集行為取決於此屬性。

VARIANT_TRUE:SQL Server Native Client OLE DB 提供者會維持一個有效的資料列集。

VARIANT_FALSE:SQL Server Native Client OLE DB 提供者會使認可作業之後的資料列集無效。資料列集物件的功能都會幾乎遺失。它僅支援 IUnknown 作業,以及未處理之資料列與存取子控制代碼的釋放。

DBPROP_DEFERRED

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:設定為 VARIANT_TRUE 時,SQL Server Native Client OLE DB 提供者會嘗試使用資料列集的伺服器資料指標。在應用程式存取 Textntextimage 資料行之前,不會從伺服器傳回這些資料行。

DBPROP_DELAYSTORAGEOBJECTS

R/W:唯讀

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者針對儲存物件支援立即更新模式。

對循序資料流物件中的資料所進行之變更會立即提交至 SQL Server。系統會根據資料列集交易模式認可這些修改。

DBPROP_HIDDENCOLUMNS

R/W:唯讀

預設值:VARIANT_FALSE

描述:隱藏的資料行計數

如果 DBPROP_UNIQUEROWS 為 VARIANT_TRUE,DBPROP_HIDDENCOLUMNS 屬性會傳回提供者所加入之其他「隱藏」資料行的數目,藉以唯一識別資料列集中的資料列。這些資料行會由 IColumnsInfo::GetColumnInfoIColumnsRowset::GetColumnsRowset 傳回。不過,這些資料行不會包含在 IColumnsInfo::GetColumnInfo 所傳回之 pcColumns 引數傳回的資料列計數中。

為判斷 IColumnsInfo::GetColumnInfo 所傳回之 prgInfo 結構中表示的資料行總數,包括隱藏的資料行,取用者會將 DBPROP_HIDDENCOLUMNS 的值加入到從 pcColumnsIColumnsInfo::GetColumnInfo 中所傳回的資料行計數。如果 DBPROP_UNIQUEROWS 為 VARIANT_FALSE,DBPROP_HIDDENCOLUMNS 為零。

DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo

R/W:唯讀

預設值:VARIANT_TRUE

描述:SQL Server Native Client OLE DB 提供者在所有資料列集上支援這些介面。

DBPROP_IColumnsRowset

R/W:讀取/寫入

預設值:VARIANT_TRUE

描述:SQL Server Native Client OLE DB 提供者支援 IColumnsRowset 介面。

DBPROP_IConnectionPointContainer

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:IConnectionPointContainer。如果是 VARIANT_TRUE,資料列集支援指定的介面。如果是 VARIANT_FALSE,資料列集不支援指定的介面。支援介面的提供者必須支援與包含 VARIANT_TRUE 值之介面相關聯的屬性。這些屬性主要用於透過 ICommandProperties::SetProperties 來要求介面。

DBPROP_IMultipleResults

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者支援 IMultipleResults 介面。

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者支援 IRowsetChangeIRowsetUpdate 介面。

使用 DBPROP_IRowsetChange 等於 VARIANT_TRUE 建立的資料列集會表現立即更新模式行為。

當 DBPROP_IRowsetUpdate 是 VARIANT_TRUE 時,DBPROP_IRowsetChange 也是 VARIANT_TRUE。資料列集會表現延遲的更新模式行為。

SQL Server Native Client OLE DB 提供者會使用 SQL Server 資料指標支援公開 IRowsetChangeIRowsetUpdate 的資料列集。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

DBPROP_IRowsetIdentity

R/W:讀取/寫入

預設值:VARIANT_TRUE

描述:SQL Server Native Client OLE DB 提供者支援 IRowsetIdentity 介面。如果資料列集支援此介面,代表相同基礎資料列的任兩個資料列控制代碼永遠會反映相同的資料和狀態。取用者可以呼叫 IRowsetIdentity:: IsSameRow 方法來比較兩個資料列控制代碼即可得知它們是否意指相同的資料列執行個體。

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者可以公開 IRowsetLocateIRowsetScroll 介面。

當 DBPROP_IRowsetLocate 是 VARIANT_TRUE 時,DBPROP_CANFETCHBACKWARDS 和 DBPROP_CANSCROLLBACKWARDS 也是 VARIANT_TRUE。

如果 DBPROP_IRowsetScroll 為 VARIANT_TRUE,DBPROP_IRowsetLocate 也為 VARIANT_TRUE,而且在資料列集上會提供這兩個介面。

這兩種介面都需要書籤。當取用者要求任一種介面時,SQL Server Native Client OLE DB 提供者會將 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 設定為 VARIANT_TRUE。

SQL Server Native Client OLE DB 提供者會使用 SQL Server 資料指標來支援 IRowsetLocateIRowsetScroll。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

設定與其他 SQL Server Native Client OLE DB 提供者資料指標定義之屬性衝突的這些屬性會造成錯誤。例如,當 DBPROP_OTHERINSERT 也為 VARIANT_TRUE 時,將 DBPROP_IRowsetScroll 設定為 VARIANT_TRUE 會在取用者嘗試開啟資料列集時產生錯誤。

DBPROP_IRowsetResynch

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者會依需求公開 IRowsetResynch 介面。SQL Server Native Client OLE DB 提供者可以在任何資料列集上公開介面。

DBPROP_ISupportErrorInfo

R/W:讀取/寫入

預設值:VARIANT_TRUE

描述:SQL Server Native Client OLE DB 提供者會在資料列集上公開 ISupportErrorInfo 介面。

DBPROP_ILockBytes

SQL Server Native Client OLE DB 提供者不會實作此介面。嘗試讀取或寫入屬性會產生錯誤。

DBPROP_ISequentialStream

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者會公開 ISequentialStream 介面來支援儲存在 SQL Server 中的可變長度長資料。

DBPROP_IStorage

SQL Server Native Client OLE DB 提供者不會實作此介面。嘗試讀取或寫入屬性會產生錯誤。

DBPROP_IStream

SQL Server Native Client OLE DB 提供者不會實作此介面。嘗試讀取或寫入屬性會產生錯誤。

DBPROP_IMMOBILEROWS

R/W:讀取/寫入

預設值:VARIANT_TRUE

描述:對於 SQL Server 索引鍵集資料指標,此屬性僅為 VARIANT_TRUE;對於其他所有資料指標,則為 VARIANT_FALSE。

VARIANT_TRUE:資料列集不會重新排列插入或更新的資料列。對於 IRowsetChange::InsertRow,資料列將會出現在資料列集的結尾。對於 IRowsetChange::SetData,如果資料列集未經過排序,則不會變更更新之資料列的位置。如果資料列集經過排序,而且 IRowsetChange::SetData 變更用於排序資料列集的資料行,則不會移動資料列。如果資料列集是在一組索引鍵資料行 (通常是 DBPROP_OTHERUPDATEDELETE 為 VARIANT_TRUE,但是 DBPROP_OTHERINSERT 為 VARIANT_FALSE 的資料列集) 上建立的,變更索引鍵資料行的值通常相當於刪除目前的資料列並插入新的資料列。因此,如果 DBPROP_OWNINSERT 為 VARIANT_FALSE,即使 DBPROP_IMMOBILEROWS 屬性為 VARIANT_TRUE,資料列可能會像是移動,或甚至從資料列集消失。

VARIANT_FALSE:如果資料列集經過排序,插入的資料列會以資料列集的正確順序顯示。如果資料列集未經過排序,插入的資料列會出現在結尾。如果 IRowsetChange::SetData 變更用於排序資料列集的資料行,則不會移動資料列。如果資料列集未經過排序,則不會變更資料列的位置。

DBPROP_LITERALIDENTITY

R/W:唯讀

預設值:VARIANT_TRUE

描述:此屬性永遠是 VARIANT_TRUE。

DBPROP_LOCKMODE

R/W:讀取/寫入

預設值:DBPROPVAL_LM_NONE

描述:資料列集 (DBPROPVAL_LM_NONE、DBPROPVAL_LM_SINGLEROW) 所執行的鎖定層級。

附註附註
在交易中使用快照隔離時,如果資料列集是使用索引鍵集或動態伺服器資料指標所開啟,而且鎖定模式設定為 DBPROPVAL_LM_SINGLEROW,提取資料列時會發生錯誤 (如果有其他人在啟動交易後更新了該資料列)。對於其他資料指標類型和鎖定模式,如果有其他人在啟動交易後更新了資料列,在使用者嘗試更新資料列前,不會發生錯誤。在兩種情況下,伺服器會產生這些錯誤。

DBPROP_MAXOPENROWS

R/W:唯讀

預設值:0

描述:SQL Server Native Client OLE DB 提供者不會限制可以在資料列集中作用的資料列數目。

DBPROP_MAXPENDINGROWS

R/W:唯讀

預設值:0

描述:SQL Server Native Client OLE DB 提供者不會限制變更暫止的資料列集資料列數目。

DBPROP_MAXROWS

R/W:讀取/寫入

預設值:0

描述:根據預設,SQL Server Native Client OLE DB 提供者不會限制資料列集中的資料列數目。當取用者設定 DBPROP_MAXROWS 時,SQL Server Native Client OLE DB 提供者會使用 SET ROWCOUNT 陳述式來限制資料列集中的資料列數目。

SET ROWCOUNT 在 SQL Server 陳述式執行時,可能會造成意外的結果。如需詳細資訊,請參閱<SET ROWCOUNT>。

DBPROP_MAYWRITECOLUMN

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_MEMORYUSAGE

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_NOTIFICATIONGRANULARITY

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_NOTIFICATIONPHASES

R/W:唯讀

預設值:DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

描述:SQL Server Native Client OLE DB 提供者支援所有告知階段。

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:唯讀

預設值:DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

描述:SQL Server Native Client OLE DB 提供者告知階段可以在嘗試執行指定的資料列集修改前取消。SQL Server Native Client OLE DB 提供者不支援在嘗試完成之後取消階段。

DBPROP_ORDEREDBOOKMARKS

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:設定變更可視性屬性會使 SQL Server Native Client OLE DB 提供者使用 SQL Server 資料指標來支援資料列集。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

DBPROP_QUICKRESTART

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:設定為 VARIANT_TRUE 時,SQL Server Native Client OLE DB 提供者會嘗試使用資料列集的伺服器資料指標。

DBPROP_REENTRANTEVENTS

R/W:唯讀

預設值:VARIANT_TRUE

描述:如果取用者嘗試從通知回呼存取不可進入的資料列集方法,SQL Server Native Client OLE DB 提供者資料列集可重新進入,而且可以傳回 DB_E_NOTREENTRANT。

DBPROP_REMOVEDELETED

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者會根據資料列集所公開之 SQL Server 資料變更的可視性,變更屬性的值。

VARIANT_TRUE:重新整理資料列集時,取用者或其他 SQL Server 使用者刪除的資料列會從資料列集移除。DBPROP_OTHERINSERT 為 VARIANT_TRUE。

VARIANT_FALSE:重新整理資料列集時,取用者或其他 SQL Server 使用者刪除的資料列不會從資料列集移除。在資料列集中,已刪除之 SQL Server 資料列的資料列狀態值為 DBROWSTATUS_E_DELETED。DBPROP_OTHERINSERT 為 VARIANT_TRUE。

此屬性僅擁有 SQL Server 資料指標所支援的資料列集值。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

當 DBPROP_REMOVEDELETED 屬性在索引鍵集資料指標資料列集上實作時,已刪除的資料列會在提取階段移除,而且資料列提取的方法 (例如,GetNextRowsGetRowsAt,) 可能會同時傳回 S_OK 以及比要求還少的資料列。請注意,此行為不表示 DB_S_ENDOFROWSET 條件,而且如果有任何剩餘的資料列,所傳回的資料列數目絕不會為零。

DBPROP_REPORTMULTIPLECHANGES

SQL Server Native Client OLE DB 提供者不會實作此資料列集屬性。嘗試讀取或寫入屬性值會產生錯誤。

DBPROP_RETURNPENDINGINSERTS

R/W:唯讀

預設值:VARIANT_FALSE

描述:呼叫提取資料列的方法時,SQL Server Native Client OLE DB 提供者不會傳回暫止的插入資料列。

DBPROP_ROWRESTRICT

R/W:唯讀

預設值:VARIANT_TRUE

描述:根據資料列,SQL Server Native Client OLE DB 提供者資料列集不支援存取權限。如果在資料列集上公開 IRowsetChange 介面,取用者可以呼叫 SetData 方法。

DBPROP_ROWSET_ASYNCH

R/W:讀取/寫入

預設值:0

描述:針對非同步資料列集處理提供。此屬性位於 Rowset 屬性群組以及 DBPROPSET_ROWSET 屬性集。類型為 VT_14。

SQL Server 在位元遮罩中支援的唯一值是 DBPROPVAL_ASYNCH_INITIALIZE。

DBPROP_ROWTHREADMODEL

R/W:唯讀

預設值:DBPROPVAL_RT_FREETHREAD

描述:SQL Server Native Client OLE DB 提供者支援從單一取用者的多個執行緒存取其物件。

DBPROP_SERVERCURSOR

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:設定時,SQL Server 資料指標用於支援資料列集。如需詳細資訊,請參閱<資料列集和 SQL Server 資料指標>。

DBPROP_SERVERDATAONINSERT

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:插入的伺服器資料

VARIANT_TRUE:將插入傳送到伺服器時,提供者會從伺服器擷取資料來更新本機資料列快取。

VARIANT_FALSE:提供者不會擷取新插入之資料列的伺服器值。

DBPROP_STRONGIDENTITY

R/W:唯讀

預設值:VARIANT_TRUE

描述:強式資料列識別。如果資料列上允許插入 (IRowsetChangeIRowsetUpdate 為 true),而且 DBPROP_UPDATABILITY 設定為支援 InsertRows,DBPROP_STRONGIDENTITY 的值相依於 DBPROP_CHANGEINSERTEDROWS 屬性 (如果 DBPROP_CHANGEINSERTEDROWS 屬性值為 VARIANT_FALSE,則為 VARIANT_FALSE)。

DBPROP_TRANSACTEDOBJECT

R/W:唯讀

預設值:VARIANT_FALSE

描述:SQL Server Native Client OLE DB 提供者僅支援交易的物件。如需詳細資訊,請參閱<交易>。

DBPROP_UNIQUEROWS

R/W:讀取/寫入

預設值:VARIANT_FALSE

描述:唯一資料列。

VARIANT_TRUE:每個資料列都會透過其資料行值唯一識別。唯一識別資料列的資料行集合已經在 GetColumnInfo 方法傳回的 DBCOLUMNINFO 結構中設定 DBCOLUMNFLAGS_KEYCOLUMN。

VARIANT_FALSE:資料列可能會也可能不會透過其資料行值唯一識別。索引鍵資料行可能會也可能不會使用 DBCOLUMNFLAGS_KEYCOLUMN 標幟。

DBPROP_UPDATABILITY

R/W:讀取/寫入

預設值:0

描述:SQL Server Native Client OLE DB 提供者支援所有 DBPROP_UPDATABILITY 值。設定 DBPROP_UPDATABILITY 並不會建立可修改的資料列集。若要讓資料列集可以修改,設定 DBPROP_IRowsetChange 或 DBPROP_IRowsetUpdate。

SQL Server Native Client OLE DB 提供者會定義提供者專屬的屬性集 DBPROPSET_SQLSERVERROWSET,如下表所示。

屬性識別碼

描述

SSPROP_COLUMN_ID

資料行:ColumnID

R/W:唯讀

類型:VT_U12 | VT_ARRAY

預設值:VT_EMPTY

描述:在目前的 Transact-SQL SELECT 陳述式中,代表 COMPUTE 子句結果資料行之序數位置 (以 1 為基底) 的整數值陣列。這是等同於 ODBC SQL_CA_SS_COLUMN_ID 屬性的 SQL Server Native Client OLE DB 提供者。

SSPROP_COMPUTE_BYLIST

資料行:ComputeByList

R/W:唯讀

類型:VT_BOOL

預設值:VARIANT_FALSE

描述:表示資料行為 COMPUTE BY 結果集一部分的布林值。這是等同於 ODBC SQL_CA_SS_COMPUTE_BYLIST 屬性的 SQL Server Native Client OLE DB 提供者。

附註附註
OLE DB 屬性是布林值,但是 ODBC 屬性實際上是包含 BY 子句所有資料行序數部分之不帶正負號短值的清單。

VARIANT_TRUE:資料行來自 COMPUTE BY 陳述式。

VARIANT_FALSE:資料行是一個一般資料行;該資料行不是來自 COMPUTE BY 陳述式。

SSPROP_COMPUTE_ID

資料行:ComputeID

R/W:唯讀

類型:VT_U12

預設值:0

描述:資料列的計算識別碼,這是目前 Transact-SQL SELECT 陳述式中的 COMPUTE 子句結果。這是等同於 ODBC SQL_CA_SS_COMPUTE_ID 屬性的 SQL Server Native Client OLE DB 提供者。

SSPROP_DEFERPREPARE

資料行:否

R/W:讀取/寫入

類型:VT_BOOL

預設值:VARIANT_TRUE

描述:VARIANT_TRUE:在備妥的執行中,命令準備會延遲,直到呼叫 ICommand::Execute,或執行中繼屬性 (metaproperty) 作業為止。如果此屬性設定為

VARIANT_FALSE:執行 ICommandPrepare::Prepare 時,會準備陳述式。

SSPROP_IRowsetFastLoad

資料行:否

R/W:讀取/寫入

類型:VT_BOOL

預設值:VARIANT_FALSE

描述:將此屬性設定為 VARIANT_TRUE 以便透過 IOpenRowset::OpenRowset 開啟快速載入資料列集。您無法在 ICommandProperties::SetProperties 中設定此屬性。

SSPROP_ISSAsynchStatus

資料行:否。

R/W:讀取/寫入

類型:VT_BOOL

預設值:VARIANT_FALSE

描述:將此屬性設定為 VARIANT_TRUE 以便使用 ISSAsynchStatus 介面啟用非同步作業。

SSPROP_MAXBLOBLENGTH

資料行:否

R/W:讀取/寫入

類型:VT_I4

預設值:提供者不會限制伺服器傳回的文字大小,而且屬性值會設定為其最大值。例如,2147483647。

描述:SQL Server Native Client OLE DB 提供者會執行 SET TEXTSIZE 陳述式來限制在 SELECT 陳述式中傳回之二進位大型物件 (BLOB) 資料的長度。

SSPROP_NOCOUNT_STATUS

資料行:NoCount

R/W:唯讀

類型:VT_BOOL

預設值:VARIANT_FALSE

描述:在 SQL Server 中,代表 SET NOCOUNT ON/OFF 狀態的布林值:

VARIANT_TRUE:當 SET NOCOUNT ON 時

VARIANT_FALSE:當 SET NOCOUNT OFF 時

SSPROP_QP_NOTIFICATION_MSGTEXT

資料行:否

R/W:讀取/寫入

類型:VT_BSTR (允許 1-2000 個字元)

預設值:空字串

描述:查詢通知的訊息文字。這是使用者定義的,而且沒有定義的格式。

SSPROP_QP_NOTIFICATION_OPTIONS

資料行:否

R/W:讀取/寫入

類型:VT_BSTR

預設值:空字串

描述:查詢通知選項。這些是使用 name=value,在字串中指定的。使用者負責建立此服務以及從佇列讀取通知。查詢通知選項字串的語法為:

service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]

例如:

service=mySSBService;local database=mydb

SSPROP_QP_NOTIFICATION_TIMEOUT

資料行:否

R/W:讀取/寫入

類型:VT_UI4

預設值:432000 秒 (5 天)

最小值:1 秒

最大值:2^31-1 秒

描述:查詢通知要維持使用中的秒數。

請參閱

概念