OLE DB 資料表值參數類型支援 (屬性)

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

屬性

以下為透過 IRowsetInfo::GetPropeties 方法，在資料表值參數資料列集物件上公開的屬性清單。 請注意，所有資料表值參數資料列集屬性都是唯讀的。 因此，嘗試透過 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

探索 ISSCommandWithParamters::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 資料表值參數類型支援