Partager via


Propriétés des ensembles de lignes (OLE DB)

Le jeu de propriétés DBPROPSET_ROWSET contient les propriétés ci-après. Toutes ces propriétés appartiennent au groupe de propriétés Rowset. D'autres propriétés sont définies dans DBPROPSET_SSCE_ROWSET.

Identifiant de la propriété

Description

DBPROP_ABORTPRESERVE

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Preserve on Abort

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_FALSE. Cette valeur indique que les seules opérations autorisées sur un ensemble de lignes après l'abandon d'une transaction sont la libération des descripteurs de ligne et d'accesseur et celle de l'ensemble de lignes.

DBPROP_ACCESSORDER

  • Type : VT_I4

  • Lecture/écriture : lecture seule

  • Description : Access Order

  • Remarque : pour ce fournisseur, la valeur est toujours DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Blocking Storage Objects

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_BOOKMARKS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Use Bookmarks

  • Remarque : indique si l'ensemble de lignes prend en charge les signets. Le fournisseur prend en charge les valeurs suivantes :

    • VARIANT_TRUE, qui indique que l'ensemble de lignes prend en charge les signets. La colonne 0 est le signet des lignes. L'obtention de cette colonne permet d'obtenir une valeur de signet. Cette valeur permet un repositionnement sur la ligne.

    • VARIANT_FALSE, qui indique que l'ensemble de lignes ne prend pas en charge les signets. L'ensemble de lignes est séquentiel et les valeurs des propriétés DBPROP_LITERALBOOKMARKS et DBPROP_ORDEREDBOOKMARKS sont ignorées.

DBPROP_BOOKMARKTYPE

  • Type : VT_UI4

  • Lecture/écriture typique : lecture seule

  • Description : Bookmark Type

  • Remarque : spécifie le type de signet pris en charge par l'ensemble de lignes. Pour ce fournisseur, la valeur est toujours DBPROPVAL_BMK_NUMERIC. Celle-ci indique que le type de signet est numérique. Les signets numériques sont basés sur les propriétés d'une ligne et ne dépendent pas des valeurs de ses colonnes. Par exemple, un signet numérique peut être basé sur la position absolue de la ligne dans l'ensemble de lignes ou sur un identificateur de ligne attribué par le moteur de stockage à une ligne lors de sa création. La modification des colonnes de la ligne n'affecte pas la validité des signets numériques.

    Les signets sont de type DBTYPE_UI4. Dans les versions antérieures à SQL Server Compact, ils étaient de type DBTYPE_I4.

DBPROP_CANFETCHBACKWARDS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Fetch Backward

  • Remarque : indique si l'ensemble de lignes peut effectuer une opération de type « fetch backward ». Le fournisseur prend en charge les valeurs suivantes :

    • VARIANT_TRUE, qui indique que la valeur de cRows dans IRowset::GetNextRows peut être négative. Si tel est le cas, cette méthode extrait les lignes vers l'arrière à partir de la ligne spécifiée.

    • VARIANT_FALSE, qui indique que la valeur cRows doit être non négative.

DBPROP_CANHOLDROWS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture

  • Description : Hold Rows

  • Remarque : pour ce fournisseur, cette propriété a toujours pour valeur VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture

  • Description : Scroll Backward

  • Remarque : pour ce fournisseur, cette propriété a toujours pour valeur VARIANT_FALSE. Cette valeur indique que la valeur de IRowsOffset doit être non négative.

DBPROP_CHANGEINSERTEDROWS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture

  • Description : Change Inserted Rows

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE. Cette valeur indique que le consommateur peut appeler IRowsetChange::DeleteRows ou IRowsetChange::SetData pour les lignes nouvellement insérées. Une ligne nouvellement insérée est définie en tant que ligne dont l'insertion a été transmise à la banque de données et non en tant que ligne en attente d'insertion.

DBPROP_COMMITPRESERVE

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Preserve On Commit

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE. Cette valeur indique qu'après une transaction conservant l'objet qui stocke les données, l'ensemble de lignes demeure actif. En d'autres termes, vous pouvez extraire de nouvelles lignes, mettre à jour, supprimer et insérer des lignes, etc.

DBPROP_DEFERRED

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Defer Column

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE. Cette valeur indique que les données de la colonne ne sont pas extraites tant qu'un accesseur n'est pas utilisé sur la colonne.

DBPROP_DELAYSTORAGEOBJECTS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Delay Storage Object Updates

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE. Cette valeur indique que les objets de stockage sont également utilisés dans le mode de mise à jour différée.

DBPROP_IAccessor

DBPROP_IColumnsInfo

DBPROP_IConvertType

DBPROP_IRowset

DBPROP_IRowsetChange

DBPROP_IRowsetInfo

DBPROP_IRowsetUpdate

DBPROP_ISupportErrorInfo

DBPROP_IRowsetIndex

DBPROP_IRowsetCurrentIndex

DBPROP_IRowsetBookmark

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture, sauf dans les cas ci-dessous.

  • Remarque : si l'une de ces propriétés a pour valeur VARIANT_TRUE, l'ensemble de lignes prend en charge l'interface spécifiée. Ces propriétés permettent essentiellement de demander des interfaces par le biais de la commande ICommandProperties::SetProperties. Les propriétés suivantes sont disponibles en lecture seule et ont toujours pour valeur VARIANT_TRUE :

    • DBPROP_IAccessor

    • DBPROP_IColumnsInfo

    • BPROP_IConvertType

    • DBPROP_IRowset

    • DBPROP_IRowsetInfo

    • DBPROP_ISupportErrorInfo

    Si vous attribuez à la propriété DBPROP_IRowsetUpdate la valeur VARIANT_TRUE, la propriété DBPROP_IRowsetChange adopte automatiquement la valeur VARIANT_TRUE. De même, si vous attribuez à la propriété DBPROP_IRowsetCurrentIndex la valeur VARIANT_TRUE, la propriété DBPROP_IRowsetIndex adopte automatiquement la valeur VARIANT_TRUE.

DBPROP_ILockBytes

DBPROP_ISequentialStream

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Remarque : si cette propriété a pour valeur VARIANT_TRUE, la colonne spécifiée est traitée en tant qu'objet de stockage qui révèle l'interface spécifiée.

DBPROP_IMMOBILEROWS

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Immobile Rows

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_FALSE. Cette valeur indique que, si l'ensemble de lignes est ordonné, les lignes insérées et les lignes mises à jour (lorsque les colonnes impliquées dans les critères de classement sont mises à jour) adoptent les critères de classement de l'ensemble de lignes. Si l'ensemble de lignes n'est pas ordonné, l'apparition à un endroit précis des lignes insérées n'est pas garantie et l'emplacement des lignes mises à jour n'est pas modifié. Cette propriété n'est pertinente que si la propriété DBPROP_OWNINSERT a pour valeur VARIANT_TRUE.

DBPROP_LOCKMODE

  • TYPE : VT_I4

  • Lecture/écriture : lecture

  • Description : Lock Mode

  • Remarque : pour ce fournisseur, la valeur est toujours DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS

  • Type : VT_I4

  • Lecture/écriture typique : lecture

  • Description : Maximum Open Rows

  • Remarque : cette valeur est 1 pour SQL Server Compact.

DBPROP_MAXROWS

  • Type : VT_I4

  • Lecture/écriture typique : lecture seule

  • Description : Maximum Rows

  • Remarque : spécifie le nombre maximum de lignes pouvant être renvoyées dans un ensemble de lignes. Si la valeur est égale à 0, il n'existe aucune limite. Pour ce fournisseur, la valeur est toujours 0.

DBPROP_OTHERINSERT

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Other's Insert.

  • Remarque : les tables de base ont pour valeur True ; les autres ont pour valeur False.

DBPROP_OTHERUPDATEDELETE

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Others' Changes Visible

  • Remarque : spécifie l'une des valeurs suivantes :

    • VARIANT_TRUE, qui indique que l'ensemble de lignes peut repérer les mises à jour et les suppressions réalisées par un utilisateur autre qu'un consommateur de l'ensemble de lignes. Par exemple, supposons qu'un utilisateur autre qu'un consommateur de l'ensemble de lignes mette à jour les données sous-jacentes d'une ligne ou qu'il supprime la ligne. Si la ligne est entièrement libérée, tout consommateur de l'ensemble de lignes peut déceler cette modification dès qu'il extrait la ligne. La modification comprend les mises à jour et les suppressions réalisées par d'autres parties dans la même transaction ainsi que celles effectuées par les parties hors de la transaction. Le niveau d'isolement de la transaction n'affecte pas la possibilité pour l'ensemble de lignes de détecter les mises à jour ou les suppressions réalisées dans la même transaction par d'autres parties, telles que d'autres ensembles de lignes dans la même session. Toutefois, il limite la possibilité pour l'ensemble de lignes de détecter les mises à jour ou les suppressions effectuées par les parties hors de la transaction ;

    • VARIANT_FALSE, qui indique que l'ensemble de lignes ne peut pas détecter les mises à jour et les suppressions réalisées par d'autres parties.

DBPROP_OWNINSERT

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Own Inserts Visible

DBPROP_OWNUPDATEDELETE

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Own Changes Visible

DBPROP_QUICKRESTART

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture/écriture

  • Description : Quick Restart

DBPROP_REMOVEDELETED

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture

  • Description : Remove Deleted Rows

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES

  • Type : VT_BOOL

  • Lecture/écriture typique : lecture seule

  • Description : Report Multiple Changes

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_ROWTHREADMODEL

  • Type : VT_I4

  • Lecture/écriture typique : lecture seule

  • Description : Row Threading Model spécifie le modèle de thread des ensembles de lignes générés par la commande. pour ce fournisseur, la valeur est toujours DBPROPVAL_RT_SINGLETHREAD.

DBPROP_SERVERDATAONINSERT

  • TYPE : VT_BOOL

  • Lecture/écriture : lecture

  • Description : Server Data on Insert

  • Remarque : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_UPDATABILITY

  • Type : VT_I4

  • Lecture/écriture typique : lecture/écriture

  • Description : Updatability