資料列集屬性和行為
適用於:SQL Server Azure SQL 資料 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System (PDW)
以下是 OLE DB Driver for SQL Server 資料列集屬性:
屬性識別碼 | 描述 |
---|---|
DBPROP_ABORTPRESERVE | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:中止操作後的資料列集行為取決於此屬性。 VARIANT_FALSE:OLE DB Driver for SQL Server 會在中止操作之後使資料列集失效。 資料列集物件的功能都會幾乎遺失。 它僅支援 IUnknown 作業,以及未處理之資料列與存取子控制代碼的釋放。 VARIANT_TRUE:OLE DB Driver for SQL Server 會維護有效的資料列集。 |
DBPROP_ACCESSORDER | R/W︰讀取/寫入 預設值:DBPROPVAL_AO_RANDOM 描述:存取順序。 必須在資料列集上存取資料行的順序。 DBPROPVAL_AO_RANDOM:資料行可以依任何順序進行存取。 DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS:作為儲存物件繫結的資料行僅能以資料行序數決定的循序順序進行存取。 DBPROPVAL_AO_SEQUENTIAL:所有資料行都必須以資料行序數決定的循序順序進行存取。 |
DBPROP_APPENDONLY | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_BLOCKINGSTORAGEOBJECTS | R/W︰唯讀 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 儲存物件會使用其他資料列集方法封鎖。 |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:當 DBPROP_BOOKMARKS 或 DBPROP_LITERALBOOKMARKS 為 VARIANT_TRUE 時,OLE DB Driver for SQL Server 支援資料列集資料列識別的書籤。 將任一個屬性設定為 VARIANT_TRUE 不會依書籤啟用資料列集定位。 將 DBPROP_IRowsetLocate 或 DBPROP_IRowsetScroll 設定為 VARIANT_TRUE 來建立支援依書籤進行資料列集定位的資料列集。 OLE DB Driver for SQL Server 會使用 Microsoft SQL Server 資料指標來支援包含書籤的資料列集。 如需詳細資訊,請參閱資料列集和 SQL Server 資料指標。 注意:設定與其他 OLE DB Driver for SQL Server 資料指標定義之屬性衝突的這些屬性會造成錯誤。 例如,當 DBPROP_OTHERINSERT 也為 VARIANT_TRUE 時,將 DBPROP_BOOKMARKS 設定為 VARIANT_TRUE 會在取用者嘗試開啟資料列集時產生錯誤。 |
DBPROP_BOOKMARKSKIPPED | R/W︰唯讀 預設值:VARIANT_FALSE 描述:如果取用者在定位或搜尋加上書籤的資料列集時指出無效的書籤,OLE DB Driver for SQL Server 會傳回 DB_E_BADBOOKMARK。 |
DBPROP_BOOKMARKTYPE | R/W︰唯讀 預設值:DBPROPVAL_BMK_NUMERIC 描述:OLE DB Driver for SQL Server 只會實作數值書籤。 OLE DB Driver for SQL Server 書籤為 32 位元不帶正負號的整數,類型 DBTYPE_UI4。 |
DBPROP_CACHEDEFERRED | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 支援在非循序的資料列集中進行反向擷取和捲動。 當 DBPROP_CANFETCHBACKWARDS 或 DBPROP_CANSCROLLBACKWARDS 為 VARIANT_TRUE 時,OLE DB Driver for SQL Server 會建立一個資料指標支援的資料列集。 如需詳細資訊,請參閱資料列集和 SQL Server 資料指標。 |
DBPROP_CANHOLDROWS | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:根據預設,如果取用者嘗試在資料列集中目前的資料列上存在暫止的變更時取得資料列集的更多資料列,OLE DB Driver for SQL Server 會傳回 DB_E_ROWSNOTRELEASED。 這個行為可以修改。 將 DBPROP_CANHOLDROWS 和 DBPROP_IRowsetChange 同時設定為 VARIANT_TRUE 意味者加上書籤的資料列集。 如果兩個屬性都為 VARIANT_TRUE,在資料列集上會提供 IRowsetLocate 介面,而且 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 都為 VARIANT_TRUE。 SQL Server 資料指標支援包含書籤的 OLE DB Driver for SQL Server 資料列集。 |
DBPROP_CHANGEINSERTEDROWS | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:如果資料列集使用的是索引鍵集驅動資料指標,僅能將此屬性設定為 VARIANT_TRUE。 |
DBPROP_COLUMNRESTRICT | R/W︰唯讀 預設值:VARIANT_FALSE 描述:當取用者無法變更資料列集中的資料行時,OLE DB Driver for SQL Server 會將屬性設定為 VARIANT_TRUE。 資料列集中的其他資料行可能可以更新,而且資料列本身可能會遭到刪除。 當屬性為 VARIANT_TRUE 時,取用者會檢查 DBCOLUMNINFO 結構的 dwFlags 成員來判斷是否可寫入個別資料行的值。 對於可修改的資料行,dwFlags 會表現 DBCOLUMNFLAGS_WRITE。 |
DBPROP_COMMANDTIMEOUT | R/W︰讀取/寫入 預設值:0 描述:根據預設,OLE DB Driver for SQL Server 在 ICommand::Execute 方法上不會逾時。 |
DBPROP_COMMITPRESERVE | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:認可作業後的資料列集行為取決於此屬性。 VARIANT_TRUE:OLE DB Driver for SQL Server 會維護有效的資料列集。 VARIANT_FALSE:OLE DB Driver for SQL Server 會使認可作業之後的資料列集失效。 資料列集物件的功能都會幾乎遺失。 它僅支援 IUnknown 作業,以及未處理之資料列與存取子控制代碼的釋放。 |
DBPROP_DEFERRED | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:設定為 VARIANT_TRUE 時,OLE DB Driver for SQL Server 會嘗試使用資料列集的伺服器資料指標。 在應用程式存取 Text、ntext 和 image 資料行之前,不會從伺服器傳回這些資料行。 |
DBPROP_DELAYSTORAGEOBJECTS | R/W︰唯讀 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 支援儲存物件的立即更新模式。 對循序資料流物件中的資料所做的變更會立即提交至 SQL Server。 系統會根據資料列集交易模式認可這些修改。 |
DBPROP_HIDDENCOLUMNS | R/W︰唯讀 預設值:VARIANT_FALSE 說明: 隱藏的資料行計數 如果 DBPROP_UNIQUEROWS 為 VARIANT_TRUE,DBPROP_HIDDENCOLUMNS 屬性會傳回提供者所加入之其他「隱藏」資料行的數目,藉以唯一識別資料列集中的資料列。 這些資料行會由 IColumnsInfo::GetColumnInfo 和 IColumnsRowset::GetColumnsRowset 傳回。 不過,這些資料行不會包含在 IColumnsInfo::GetColumnInfo 所傳回之 pcColumns 引數傳回的資料列計數中。 為判斷 IColumnsInfo::GetColumnInfo 所傳回之 prgInfo 結構中表示的資料行總數,包括隱藏的資料行,取用者會將 DBPROP_HIDDENCOLUMNS 的值加入到從 pcColumns 之 IColumnsInfo::GetColumnInfo 中所傳回的資料行計數。 如果 DBPROP_UNIQUEROWS 為 VARIANT_FALSE,DBPROP_HIDDENCOLUMNS 為零。 |
DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo | R/W︰唯讀 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 支援所有資料列集上的這些介面。 |
DBPROP_IColumnsRowset | R/W︰讀取/寫入 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 支援 IColumnsRowset 介面。 |
DBPROP_IConnectionPointContainer | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:IConnectionPointContainer。 如果是 VARIANT_TRUE,資料列集支援指定的介面。 如果是 VARIANT_FALSE,資料列集不支援指定的介面。 支援介面的提供者必須支援與包含 VARIANT_TRUE 值之介面相關聯的屬性。 這些屬性主要用於透過 ICommandProperties::SetProperties 來要求介面。 |
DBPROP_IMultipleResults | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 支援 IMultipleResults 介面。 |
DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 支援 IRowsetChange 和 IRowsetUpdate 介面。 使用 DBPROP_IRowsetChange 等於 VARIANT_TRUE 建立的資料列集會表現立即更新模式行為。 當 DBPROP_IRowsetUpdate 是 VARIANT_TRUE 時,DBPROP_IRowsetChange 也是 VARIANT_TRUE。 資料列集會表現延遲的更新模式行為。 OLE DB Driver for SQL Server 會使用 SQL Server 資料指標支援公開 IRowsetChange 或 IRowsetUpdate 的資料列集。 如需詳細資訊,請參閱資料列集和 SQL Server 資料指標。 |
DBPROP_IRowsetIdentity | R/W︰讀取/寫入 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 支援 IRowsetIdentity 介面。 如果資料列集支援此介面,代表相同基礎資料列的任兩個資料列控制代碼永遠會反映相同的資料和狀態。 取用者可以呼叫 IRowsetIdentity::IsSameRow 方法來比較兩個資料列控制代碼即可得知它們是否意指相同的資料列執行個體。 |
DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 可以公開 IRowsetLocate 和 IRowsetScroll 介面。 當 DBPROP_IRowsetLocate 是 VARIANT_TRUE 時,DBPROP_CANFETCHBACKWARDS 和 DBPROP_CANSCROLLBACKWARDS 也是 VARIANT_TRUE。 如果 DBPROP_IRowsetScroll 為 VARIANT_TRUE,DBPROP_IRowsetLocate 也為 VARIANT_TRUE,而且在資料列集上會提供這兩個介面。 這兩種介面都需要書籤。 當取用者要求任一種介面時,OLE DB Driver for SQL Server 會將 DBPROP_BOOKMARKS 和 DBPROP_LITERALBOOKMARKS 設定為 VARIANT_TRUE。 OLE DB Driver for SQL Server 會使用 SQL Server 資料指標來支援 IRowsetLocate 和 IRowsetScroll。 如需詳細資訊,請參閱資料列集和 SQL Server 資料指標。 設定與其他 OLE DB Driver for SQL Server 資料指標定義之屬性衝突的這些屬性會造成錯誤。 例如,當 DBPROP_OTHERINSERT 也為 VARIANT_TRUE 時,將 DBPROP_IRowsetScroll 設定為 VARIANT_TRUE 會在取用者嘗試開啟資料列集時產生錯誤。 |
DBPROP_IRowsetResynch | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 會視需要公開 IRowsetResynch 介面。 OLE DB Driver for SQL Server 可以在任何資料列集上公開介面。 |
DBPROP_ISupportErrorInfo | R/W︰讀取/寫入 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 會在資料列集上公開 ISupportErrorInfo 介面。 |
DBPROP_ILockBytes | OLE DB Driver for SQL Server 不會實作此介面。 嘗試讀取或寫入屬性會產生錯誤。 |
DBPROP_ISequentialStream | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 會公開 ISequentialStream 介面以支援儲存在 SQL Server 中的可變長度長資料。 |
DBPROP_IStorage | OLE DB Driver for SQL Server 不會實作此介面。 嘗試讀取或寫入屬性會產生錯誤。 |
DBPROP_IStream | OLE DB Driver for SQL Server 不會實作此介面。 嘗試讀取或寫入屬性會產生錯誤。 |
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 描述:OLE DB Driver for SQL Server 不會限制可以在資料列集中作用的資料列數目。 |
DBPROP_MAXPENDINGROWS | R/W︰唯讀 預設值:0 描述:OLE DB Driver for SQL Server 不會限制變更暫止的資料列集資料列數目。 |
DBPROP_MAXROWS | R/W︰讀取/寫入 預設值:0 描述:根據預設,OLE DB Driver for SQL Server 不會限制資料列集中的資料列數目。 當取用者設定 DBPROP_MAXROWS 時,OLE DB Driver for SQL Server 會使用 SET ROWCOUNT 陳述式來限制資料列集中的資料列數目。 在 SQL Server 陳述式執行中,SET ROWCOUNT 可能會造成非預期的結果。 如需詳細資訊,請參閱 SET ROWCOUNT。 |
DBPROP_MAYWRITECOLUMN | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_MEMORYUSAGE | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_NOTIFICATIONGRANULARITY | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_NOTIFICATIONPHASES | R/W︰唯讀 預設值:DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT 描述:OLE DB Driver for SQL Server 支援所有通知階段。 |
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 描述:OLE DB Driver for SQL Server 通知階段可以在嘗試執行指定的資料列集修改前取消。 OLE DB Driver for SQL Server 不支援在嘗試完成之後取消階段。 |
DBPROP_ORDEREDBOOKMARKS | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:設定變更可見度屬性,會使 OLE DB Driver for SQL Server 使用 SQL Server 資料指標來支援資料列集。 如需詳細資訊,請參閱資料列集和 SQL Server 資料指標。 |
DBPROP_QUICKRESTART | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:設定為 VARIANT_TRUE 時,OLE DB Driver for SQL Server 會嘗試使用資料列集的伺服器資料指標。 |
DBPROP_REENTRANTEVENTS | R/W︰唯讀 預設值:VARIANT_TRUE 描述:如果取用者嘗試從通知回呼存取不可重新進入的資料列集方法,OLE DB Driver for SQL Server 資料列集可重新進入,而且可以傳回 DB_E_NOTREENTRANT。 |
DBPROP_REMOVEDELETED | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 會根據資料列集所公開之 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 屬性在索引鍵集資料指標資料列集上實作時,已刪除的資料列會在擷取階段移除,而且資料列擷取的方法 (例如 GetNextRows 和 GetRowsAt, ) 可能會同時傳回 S_OK 以及比要求還少的資料列。 請注意,此行為不表示 DB_S_ENDOFROWSET 條件,而且如果有任何剩餘的資料列,所傳回的資料列數目絕不會為零。 |
DBPROP_REPORTMULTIPLECHANGES | OLE DB Driver for SQL Server 不會實作此資料列集屬性。 嘗試讀取或寫入屬性值會產生錯誤。 |
DBPROP_RETURNPENDINGINSERTS | R/W︰唯讀 預設值:VARIANT_FALSE 描述:呼叫擷取資料列的方法時,OLE DB Driver for SQL Server 不會傳回暫止的插入資料列。 |
DBPROP_ROWRESTRICT | R/W︰唯讀 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 資料列集不支援以資料列為基礎的存取權。 如果在資料列集上公開 IRowsetChange 介面,取用者可以呼叫 SetData 方法。 |
DBPROP_ROWSET_ASYNCH | R/W︰讀取/寫入 預設值:0 描述:針對非同步資料列集處理提供。 此屬性位於 Rowset 屬性群組以及 DBPROPSET_ROWSET 屬性集。 類型為 VT_14。 OLE DB Driver for SQL Server 所支援之位元遮罩中唯一的值是 DBPROPVAL_ASYNCH_INITIALIZE。 |
DBPROP_ROWTHREADMODEL | R/W︰唯讀 預設值:DBPROPVAL_RT_FREETHREAD 描述:OLE DB Driver for SQL Server 支援從單一取用者的多個執行緒存取其物件。 |
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 描述:強式資料列識別。 如果資料列集上允許插入 (IRowsetChange 或 IRowsetUpdate 為 true),而且 DBPROP_UPDATABILITY 設定為支援 InsertRows,DBPROP_STRONGIDENTITY 的值相依於 DBPROP_CHANGEINSERTEDROWS 屬性 (如果 DBPROP_CHANGEINSERTEDROWS 屬性值為 VARIANT_FALSE,則為 VARIANT_FALSE)。 |
DBPROP_TRANSACTEDOBJECT | R/W︰唯讀 預設值:VARIANT_FALSE 描述:OLE DB Driver for SQL Server 只支援交易物件。 如需詳細資訊,請參閱交易。 |
DBPROP_UNIQUEROWS | R/W︰讀取/寫入 預設值:VARIANT_FALSE 描述:唯一資料列。 VARIANT_TRUE:每個資料列都會透過其資料行值唯一識別。 唯一識別資料列的資料行集合已經在 GetColumnInfo 方法傳回的 DBCOLUMNINFO 結構中設定 DBCOLUMNFLAGS_KEYCOLUMN。 VARIANT_FALSE:資料列可能會也可能不會透過其資料行值唯一識別。 索引鍵資料行可能會也可能不會使用 DBCOLUMNFLAGS_KEYCOLUMN 標幟。 |
DBPROP_UPDATABILITY | R/W︰讀取/寫入 預設值:0 描述:OLE DB Driver for SQL Server 支援所有 DBPROP_UPDATABILITY 值。 設定 DBPROP_UPDATABILITY 並不會建立可修改的資料列集。 若要讓資料列集可以修改,設定 DBPROP_IRowsetChange 或 DBPROP_IRowsetUpdate。 |
OLE DB Driver for SQL Server 會定義提供者特定的屬性集 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 屬性的 OLE DB Driver for SQL Server。 |
SSPROP_DEFERPREPARE | 資料行:否 R/W︰讀取/寫入 輸入:VT_BOOL 預設值:VARIANT_TRUE 描述:VARIANT_TRUE:在備妥的執行中,命令準備會延遲,直到呼叫 ICommand::Execute,或執行中繼屬性作業為止。 如果此屬性設定為 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_ISSDataClassification | R/W︰讀取/寫入 輸入:VT_BOOL 預設值:VARIANT_TRUE 描述:OLE DB Driver for SQL Server 支援使用 ISSDataClassification 介面擷取敏感性分類資訊。 |
SSPROP_MAXBLOBLENGTH | 資料行:否 R/W︰讀取/寫入 輸入:VT_I4 預設值:提供者不會限制伺服器傳回的文字大小,而且屬性值會設定為其最大值。 例如,2147483647。 描述:OLE DB Driver for SQL Server 會執行 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 秒 描述:查詢通知要維持使用中的秒數。 |