Prise en charge du type de paramètre table OLE DB (Propriétés)
Cette rubrique fournit des informations sur les propriétés et les jeux de propriétés OLE DB associés aux objets d'ensemble de lignes de paramètre table.
Propriétés
La liste qui suit répertorie les propriétés dévoilées via la méthodeIRowsetInfo::GetPropeties dans les objets d'ensemble de lignes de paramètre table. Notez que toutes les propriétés de l'ensemble de lignes de paramètre table sont en lecture seule. Par conséquent, si vous tentez de définir l'une des propriétés par le biais des méthodes IOpenRowset::OpenRowset ou ITableDefinitionWithConstraints::CreateTableWithConstraints sur des valeurs autres que leurs valeurs par défaut, vous obtiendrez une erreur et aucun objet ne sera créé.
Les propriétés non implémentées dans l'objet d'ensemble de lignes de paramètre table n'apparaissent pas dans cette liste. Pour obtenir une liste complète des propriétés, consultez la documentation OLE DB dans Windows Data Access Components.
ID de propriété |
Valeur |
|---|---|
DBPROP_ABORTPRESERVE |
VARIANT_TRUE |
DBPROP_ACCESSORDER |
DBPROPVAL_AO_RANDOM |
DBPROP_BLOCKINGSTORAGEOBJECTS |
VARIANT_TRUE |
DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS |
Lecture/écriture : lecture seule Valeur par défaut : VARIANT_FALSE Description : les signets ne sont pas autorisés dans les objets d'ensemble de lignes de paramètre table. |
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 Remarque : l'objet d'ensemble de lignes de paramètre table prend en charge les interfaces IRowsetChange. Un ensemble de lignes créé en utilisant DBPROP_IRowsetChange avec la valeur VARIANT_TRUE dévoile les comportements du mode de mise à jour immédiate. Toutefois, si des colonnes BLOB sont liées en tant qu'objets ISequentialStream, le consommateur doit normalement les conserver pendant toute la durée de vie de l'objet d'ensemble de lignes de paramètre table. |
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 |
Jeux de propriétés
Les jeux de propriétés suivants prennent en charge les paramètres table.
DBPROPSET_SQLSERVERCOLUMN
Cette propriété est utilisée par le consommateur au cours du processus de création d'un objet d'ensemble de lignes de paramètre table en utilisant ITableDefinitionWithConstraints::CreateTableWithConstraints pour chaque colonne via la structure DBCOLUMNDESC (si nécessaire).
ID de propriété |
Valeur de la propriété |
|---|---|
SSPROP_COL_COMPUTED |
Lecture/écriture : lecture/écriture Valeur par défaut : VARIANT_FALSE Type : VT_BOOL Description : cette propriété, si elle est définie sur VARIANT_TRUE, indique que la colonne est une colonne calculée. La valeur VARIANT_FALSE indique qu'il ne s'agit pas d'une colonne calculée. |
DBPROPSET_SQLSERVERPARAMETER
Ces propriétés sont lues par le consommateur lors de la détection des informations sur le type de paramètre table lors des appels à ISSCommandWithParamters::GetParameterProperties et sont définies par le consommateur au moment de définir les propriétés spécifiques relatives au paramètre table via ISSCommandWithParameters::SetParameterProperties.
Le tableau qui suit offre des descriptions détaillées de ces propriétés.
ID de propriété |
Valeur de la propriété |
|---|---|
SSPROP_PARAM_TYPE_TYPENAME |
Lecture/écriture : lecture/écriture Valeur par défaut : VT_EMPTY Type : VT_BSTR Description : les consommateurs utilisent cette propriété pour se procurer ou définir le type de paramètre table. Vous pouvez également utiliser cette propriété avec des types CLR définis par l'utilisateur. Vous pouvez, si vous le souhaitez, la spécifier afin de préciser un nom de type de table pour un paramètre table (en cas d'utilisation d'une commande de syntaxe d'appel ODBC). Cette propriété est obligatoire pour les requêtes paramétrables SQL ad hoc. |
SSPROP_PARAM_TYPE_SCHEMANAME |
Lecture/écriture : lecture/écriture Valeur par défaut : VT_EMPTY Type : VT_BSTR Description : les consommateurs utilisent cette propriété pour se procurer ou définir le nom de schéma du type de paramètre table. Vous pouvez également utiliser cette propriété avec des types CLR définis par l'utilisateur. |
SSPROP_PARAM_TYPE_CATALOGNAME |
Lecture/écriture : lecture seule Valeur par défaut : VT_EMPTY Type : VT_BSTR Description : les consommateurs utilisent cette propriété pour se procurer ou définir le nom de catalogue du type de paramètre table. Vous pouvez également utiliser cette propriété avec des types CLR définis par l'utilisateur. La définition de cette propriété est une erreur ; les types de tables définis par l'utilisateur doivent figurer dans la même base de données que les paramètres table qui les utilisent. |
SSPROP_PARAM_TABLE_DEFAULT_COLUMNS |
Lecture/écriture : lecture/écriture Valeur par défaut : VT_EMPTY Type : VT_UI2 | VT_ARRAY Description : les consommateurs utilisent cette propriété pour spécifier quelles colonnes dans l'ensemble de lignes seront traitées en tant que valeurs par défaut. Aucune valeur ne sera envoyée pour ces colonnes. Au moment d'extraire des données de l'objet d'ensemble de lignes du consommateur, le fournisseur n'exige aucune liaison pour ces colonnes. Chaque élément du tableau doit désigner l'ordinal d'une colonne dans l'objet d'ensemble de lignes. Les ordinaux non valides génèrent des erreurs lors de l'exécution des commandes. |
SSPROP_PARAM_TABLE_COLUMN_ORDER |
Lecture/écriture : lecture/écriture Valeur par défaut : VT_EMPTY Type : VT_UI2 | VT_ARRAY Description : cette propriété est utilisée par le consommateur pour indiquer au serveur l'ordre de tri des données des colonnes. Le fournisseur n'effectue aucune validation et part du principe que le consommateur agit conformément à la spécification fournie. Le serveur utilise cette propriété pour procéder à des optimisations. Les informations d'ordre des colonnes pour chaque colonne sont représentées par une paire d'éléments dans le tableau. Le premier élément dans la paire correspond au numéro de la colonne. Le deuxième élément dans la paire sera 1 pour l'ordre croissant ou 2 pour l'ordre décroissant. |