Share via

SQL Server Native Client 中的 OLE DB 資料表值參數類型支援 （屬性）

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics Platform System (PDW)

本主題提供與資料表值參數資料列集物件相關聯之 OLE DB 屬性和屬性集的相關資訊。

屬性

以下為透過 IRowsetInfo::GetProperties 方法，在資料表值參數資料列集物件上公開的屬性清單。 請注意，所有資料表值參數資料列集屬性都是唯讀的。 因此，嘗試透過 IOpenRowset::OpenRowset 或 ITableDefinitionWithConstraints::CreateTableWithConstraints 方法將任何屬性設定為其非預設值將會導致錯誤，且不會建立任何物件。

沒有在資料表值參數資料列集物件中實作的屬性不會列在此處。 如需屬性的完整清單，請參閱 OLE DB 文件集中的＜Windows Data Access Components＞。

屬性識別碼 值
DBPROP_ABORTPRESERVE VARIANT_TRUE
DBPROP_ACCESSORDER DBPROPVAL_AO_RANDOM
DBPROP_BLOCKINGSTORAGEOBJECTS VARIANT_TRUE
DBPROP_BOOKMARKS

DBPROP_LITERALBOOKMARKS		 R/W︰唯讀

預設值：VARIANT_FALSE

描述：在資料表值參數資料列集物件上不允許使用書籤。
DBPROP_BOOKMARKSKIPPED VARIANT_FALSE
DBPROP_BOOKMARKTYPE DBPROPVAL_BMK_NUMERIC
DBPROP_CANHOLDROWS VARIANT_FALSE
DBPROP_CHANGEINSERTEDROWS VARIANT_TRUE
DBPROP_COLUMNRESTRICT VARIANT_FALSE
DBPROP_COMMANDTIMEOUT 0
DBPROP_COMMITPRESERVE VARIANT_TRUE
DBPROP_DEFERRED VARIANT_FALSE
DBPROP_DELAYSTORAGEOBJECTS VARIANT_FALSE
DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetInfo

DBPROP_IColumnsRowset		 VARIANT_TRUE
DBPROP_IConnectionPointContainer

DBPROP_IMultipleResults

DBPROP_IRowsetUpdate

DBPROP_IRowsetIdentity

DBPROP_IRowsetLocate

DBPROP_IRowsetScroll

DBPROP_IRowsetResynch		 VARIANT_FALSE
DBPROP_IRowsetChange VARIANT_TRUE

注意:資料表值參數資料列集物件支援 IRowsetChange 介面。

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

不過，如果 BLOB 資料行當做 ISequentialStream 物件繫結，取用者應該在資料表值參數資料列集物件的存留期予以保留。
DBPROP_ISupportErrorInfo VARIANT_TRUE
DBPROP_ISequentialStream VARIANT_TRUE
DBPROP_IMMOBILEROWS VARIANT_TRUE
DBPROP_LITERALIDENTITY VARIANT_TRUE
DBPROP_LOCKMODE DBPROPVAL_LM_NONE
DBPROP_MAXOPENROWS 0
DBPROP_MAXPENDINGROWS 0
DBPROP_MAXROWS 0
DBPROP_NOTIFICATIONPHASES 0
DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE 0
DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE VARIANT_FALSE
DBPROP_OWNINSERT

DBPROP_OWNUPDATEDELETE		 VARIANT_TRUE
DBPROP_QUICKRESTART VARIANT_TRUE
DBPROP_REENTRANTEVENTS VARIANT_FALSE
DBPROP_REMOVEDELETED VARIANT_TRUE
DBPROP_RETURNPENDINGINSERTS VARIANT_TRUE
DBPROP_ROWRESTRICT VARIANT_FALSE
DBPROP_ROWTHREADMODEL DBPROPVAL_RT_FREETHREAD
DBPROP_SERVERCURSOR VARIANT_FALSE
DBPROP_SERVERDATAONINSERT VARIANT_FALSE
DBPROP_STRONGIDENTITY VARIANT_TRUE
DBPROP_TRANSACTEDOBJECT VARIANT_FALSE
DBPROP_UNIQUEROWS VARIANT_FALSE
DBPROP_UPDATABILITY DBPROPVAL_UP_CHANGE | DBPROPVAL_UP_DELETE | DBPROPVAL_UP_INSERT

屬性集

下列屬性集支援資料表值參數。

DBPROPSET_SQLSERVERCOLUMN

這個屬性會由取用者在建立資料表值參數資料列集物件時，如果需要透過 DBCOLUMNDESC 結構針對每個資料行使用 ITableDefinitionWithConstraints::CreateTableWithConstraints 來建立時使用。

屬性識別碼 屬性值
SSPROP_COL_COMPUTED R/W︰讀取/寫入

預設值：VARIANT_FALSE

輸入：VT_BOOL

描述：設定為 VARIANT_TRUE 時，表示資料行為計算資料行。 VARIANT_FALSE 則表示它不是計算資料行。

DBPROPSET_SQLSERVERPARAMETER

這些屬性會由取用者在探索針對 ISSCommandWithParameters::GetParameterProperties 之呼叫中的資料表值參數類型資訊時讀取，以及由取用者在透過 ISSCommandWithParameters::SetParameterProperties 設定關於資料表值參數的指定屬性時設定。

下表提供這些屬性的詳細描述。

屬性識別碼 屬性值
SSPROP_PARAM_TYPE_TYPENAME R/W︰讀取/寫入

預設值：VT_EMPTY

輸入：VT_BSTR

描述：取用者會使用這個屬性來取得或設定資料表值參數類型的名稱。

這個屬性也可以搭配 CLR 使用者定義型別使用。

您可以選擇性地指定這個屬性來提供資料表值參數的資料表類型名稱 (如果是 ODBC 呼叫語法命令)。 特定參數化的 SQL 查詢需要使用這個屬性。
SSPROP_PARAM_TYPE_SCHEMANAME R/W︰讀取/寫入

預設值：VT_EMPTY

輸入：VT_BSTR

描述：取用者會使用這個屬性來取得或設定資料表值參數類型的結構描述名稱。

這個屬性也可以搭配 CLR 使用者定義型別使用。
SSPROP_PARAM_TYPE_CATALOGNAME R/W︰唯讀

預設值：VT_EMPTY

輸入：VT_BSTR

描述：取用者會使用這個屬性來取得資料表值參數類型的目錄名稱。

這個屬性也可以搭配 CLR 使用者定義型別使用。 設定此屬性是錯誤的；使用者定義資料表類型必須與使用這些類型的資料表值參數位於相同的資料庫中。
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS R/W︰讀取/寫入

預設值：VT_EMPTY

類型：VT_UI2 | VT_ARRAY

描述：取用者會使用這個屬性來指定要將資料列集中的哪組資料行視為預設值。 系統不會針對這些資料行傳送任何值。 從取用者資料列集物件中提取資料時，提供者不需要使用此類資料行的繫結。

陣列的每個元素都應該是資料列集物件中的資料行序數。 在命令執行階段，無效的序數將會導致錯誤。
SSPROP_PARAM_TABLE_COLUMN_ORDER R/W︰讀取/寫入

預設值：VT_EMPTY

類型：VT_UI2 | VT_ARRAY

描述：取用者會使用這個屬性來提供提示給伺服器，指出資料行資料的排序次序。 提供者不會執行任何驗證，並假設取用者符合所提供的規格。 伺服器會使用這個屬性來執行最佳化。

每個資料行的資料行順序資訊都會以陣列中的一組元素表示。 配對中的第一個元素是資料行的數目。 配對中的第二個元素將為 1 (遞增的順序) 或 2 (遞減的順序)。

另請參閱

OLE DB 資料表值參數類型支援
使用資料表值參數 (OLE DB)