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 : lecture seule
  • Description : Preserve on Abort
  • Remarques : 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
  • Remarques : pour ce fournisseur, la valeur est toujours DBPROPVAL_AO_RANDOM.

DBPROP_BLOCKINGSTORAGEOBJECTS
  • Type : VT_BOOL
  • Lecture/écriture : lecture seule
  • Description : Blocking Storage Objects
  • Remarques : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_BOOKMARKS
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Use Bookmarks
  • Remarques : 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 : lecture seule
  • Description : Bookmark Type
  • Remarques : 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 de SQL Server 2005 Compact Edition, ils étaient de type DBTYPE_I4.

DBPROP_CANFETCHBACKWARDS
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Fetch Backward
  • Remarques : 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 : lecture
  • Description : Hold Rows
  • Remarque : pour ce fournisseur, cette propriété a toujours pour valeur VARIANT_FALSE.

DBPROP_CANSCROLLBACKWARDS
  • Type : VT_BOOL
  • Lecture/écriture : lecture
  • Description : défilement arrière
  • Remarques : 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 : lecture
  • Description : Change Inserted Rows
  • Remarques : 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 : lecture seule
  • Description : Preserve On Commit
  • Remarques : 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 : lecture seule
  • Description : Defer Column
  • Remarques : 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 : lecture seule
  • Description : Delay Storage Object Updates
  • Remarques : 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 : lecture/écriture, sauf dans les cas ci-dessous.
  • Remarques : 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 : lecture/écriture
  • Remarques : 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 : lecture seule
  • Description : Immobile Rows
  • Remarques : 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
  • Remarques : pour ce fournisseur, la valeur est toujours DBPROPVAL_LM_SINGLEROW.

DBPROP_MAXOPENROWS
  • Type : VT_I4
  • Lecture/écriture : L
  • Description : Maximum Open Rows
  • Remarques : cette valeur est égale à 1 pour SQL Server Compact Edition.

DBPROP_MAXROWS
  • Type : VT_I4
  • Lecture/écriture : lecture seule
  • Description : Maximum Rows
  • Remarques : spécifie le nombre maximum de lignes pouvant être renvoyées dans un ensemble de lignes. En l'absence de limite, cette valeur est 0. Pour ce fournisseur, la valeur est toujours 0.

DBPROP_OTHERINSERT
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Other's Insert.
  • Remarques : les tables de base ont pour valeur True ; les autres ont pour valeur False.

DBPROP_OTHERUPDATEDELETE
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Others' Changes Visible
  • Remarques : 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 : lecture/écriture
  • Description : Own Inserts Visible

DBPROP_OWNUPDATEDELETE
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Own Changes Visible

DBPROP_QUICKRESTART
  • Type : VT_BOOL
  • Lecture/écriture : lecture/écriture
  • Description : Quick Restart

DBPROP_REMOVEDELETED
  • Type : VT_BOOL
  • Lecture/écriture : lecture
  • Description : Remove Deleted Rows
  • Remarques : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_REPORTMULTIPLECHANGES
  • Type : VT_BOOL
  • Lecture/écriture : lecture seule
  • Description : Report Multiple Changes
  • Remarques : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_ROWTHREADMODEL
  • Type : VT_I4
  • Lecture/écriture : 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
  • Remarques : pour ce fournisseur, la valeur est toujours VARIANT_TRUE.

DBPROP_UPDATABILITY
  • Type : VT_I4
  • Lecture/écriture : lecture/écriture
  • Description : Updatability

Voir aussi

Aide et information

Assistance sur SQL Server Compact Edition

  • Last updated on