Compatibilidad con tipos de parámetros con valores de tabla de OLE DB (propiedades)
En este tema se proporciona información sobre las propiedades de OLE DB y los conjuntos de propiedades asociados a los objetos de conjunto de filas de parámetro con valores de tabla.
Propiedades
A continuación figura la lista de propiedades expuestas mediante el método IRowsetInfo::GetPropeties en los objetos de conjunto de filas de parámetro con valores de tabla. Observe que todas las propiedades de conjunto de filas de parámetro con valores de tabla son de sólo lectura. Por lo tanto, si se intenta establecer cualquiera de las propiedades mediante los métodos IOpenRowset::OpenRowset o ITableDefinitionWithConstraints::CreateTableWithConstraints en sus valores no predeterminados, se producirá un error y no se creará ningún objeto.
No se enumeran aquí las propiedades no implementadas en el objeto de conjunto de filas de parámetro con valores. Para obtener una lista completa de las propiedades, vea la documentación de OLE DB en Data Access Components para Windows.
Id. de propiedad |
Valor |
|---|---|
DBPROP_ABORTPRESERVE |
VARIANT_TRUE |
DBPROP_ACCESSORDER |
DBPROPVAL_AO_RANDOM |
DBPROP_BLOCKINGSTORAGEOBJECTS |
VARIANT_TRUE |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS |
L/E: de sólo lectura Valor predeterminado: VARIANT_FALSE Descripción: no se permiten marcadores en los objetos de conjunto de filas de parámetro con valores de tabla. |
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 Nota: el objeto de conjunto de filas de parámetro con valores de tabla admite las interfaces IRowsetChange. Los conjuntos de filas creados utilizando DBPROP_IRowsetChange igual a VARIANT_TRUE exhiben los comportamientos de modo de actualización inmediatos. Sin embargo, si las columnas BLOB se enlazan como objetos ISequentialStream, se espera que el consumidor las mantenga durante la vigencia del objeto de conjunto de filas de parámetro con valores de tabla. |
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 |
Conjuntos de propiedades
La propiedad siguiente establece los parámetros con valores de tabla admitidos.
DBPROPSET_SQLSERVERCOLUMN
El consumidor utiliza esta propiedad en el proceso de crear un objeto de conjunto de filas de parámetro con valores de tabla utilizando ITableDefinitionWithConstraints::CreateTableWithConstraints para cada columna a través de la estructura DBCOLUMNDESC, si es necesario.
Id. de propiedad |
Valor de la propiedad |
|---|---|
SSPROP_COL_COMPUTED |
L/E: de lectura/escritura Valor predeterminado: VARIANT_FALSE Tipo: VT_BOOL Descripción: cuando se establece en VARIANT_TRUE, indica que la columna es calculada. VARIANT_FALSE indica que no es una columna calculada. |
DBPROPSET_SQLSERVERPARAMETER
El consumidor lee estas propiedades mientras se detecta la información del tipo de parámetro con valores de tabla en las llamadas a ISSCommandWithParamters::GetParameterProperties y el consumidor las establece al mismo tiempo que las propiedades concretas sobre el parámetro con valores de tabla a través de ISSCommandWithParameters::SetParameterProperties.
En la tabla siguiente se proporcionan descripciones detalladas de estas propiedades.
Id. de propiedad |
Valor de la propiedad |
|---|---|
SSPROP_PARAM_TYPE_TYPENAME |
L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Esta propiedad se puede especificar opcionalmente para proporcionar un nombre de tipo de tabla para un parámetro con valores de tabla (en caso del comando de sintaxis de llamada ODBC). Esta propiedad es necesaria para las consultas SQL parametrizadas ad hoc. |
SSPROP_PARAM_TYPE_SCHEMANAME |
L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener o establecer el nombre de esquema del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. |
SSPROP_PARAM_TYPE_CATALOGNAME |
L/E: de sólo lectura Valor predeterminado: VT_EMPTY Tipo: VT_BSTR Descripción: los consumidores utilizan esta propiedad para obtener el nombre de catálogo del tipo de parámetro con valores de tabla. Esta propiedad se puede utilizar también con tipos definidos por el usuario CLR. Es un error establecer esta propiedad; los tipos de tabla definidos por el usuario deben estar en la misma base de datos que los parámetros con valores de tabla que los usan. |
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS |
L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: los consumidores usan esta propiedad para especificar qué conjunto de columnas del conjunto de filas será tratado como valores predeterminados. No se enviará ningún valor para esas columnas. Al capturar datos del objeto de conjunto de filas del consumidor, el proveedor no requiere un enlace para tales columnas. Todos los elementos de la matriz deben ser ordinales de columnas del objeto de conjunto de filas. Los ordinales no válidos producirán errores durante la ejecución del comando. |
SSPROP_PARAM_TABLE_COLUMN_ORDER |
L/E: de lectura/escritura Valor predeterminado: VT_EMPTY Tipo: VT_UI2 | VT_ARRAY Descripción: el consumidor utiliza esta propiedad para proporcionar una sugerencia al servidor que indica el orden de clasificación de los datos de columna. El proveedor no realiza ninguna validación y asume que el consumidor se ajusta a la especificación que se proporcionó. El servidor usa esta propiedad para realizar las optimizaciones. La información de orden de las columnas para cada columna se representa mediante un par de elementos de la matriz. El primer elemento del par es el número de la columna. El segundo elemento del par será 1 para el orden ascendente o 2 para el orden descendente. |