OLE DB 資料表值參數類型支援 (屬性)
適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics 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 (遞減的順序)。 |