Partager via


Propriétés et comportements de l'ensemble de lignes

Il s'agit des propriétés de l'ensemble de lignes du fournisseur OLE DB de SQL Server Native Client.

Identifiant de la propriété

Description

DBPROP_ABORTPRESERVE

L/E : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le comportement d'un ensemble de lignes après une opération d'abandon est déterminé par cette propriété.

VARIANT_FALSE : le fournisseur OLE DB de SQL Server Native Client invalide les ensembles de lignes après une opération d'abandon. Les fonctionnalités de l'objet d'ensemble de lignes sont quasiment perdues. Seules les opérations IUnknown et la libération des handles de ligne et d'accesseur en attente sont prises en charge.

VARIANT_TRUE : le fournisseur OLE DB de SQL Server Native Client conserve un ensemble de lignes valide.

DBPROP_ACCESSORDER

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : DBPROPVAL_AO_RANDOM

Description : ordre d'accès. Ordre dans lequel les colonnes doivent être accessibles dans l'ensemble de lignes.

DBPROPVAL_AO_RANDOM : les colonnes sont accessibles dans n'importe quel ordre.

DBPROPVAL_AO_SEQUENTIALSTORAGEOBJECTS : les colonnes liées en tant qu'objets de stockage sont accessibles uniquement dans l'ordre séquentiel déterminé par l'ordinal de colonne.

DBPROPVAL_AO_SEQUENTIAL : toutes les colonnes doivent être accessibles dans l'ordre séquentiel déterminé par l'ordinal de colonne.

DBPROP_APPENDONLY

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_BLOCKINGSTORAGEOBJECTS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : les objets de stockage du fournisseur OLE DB de SQL Server Native Client bloquent l'utilisation d'autres méthodes d'ensemble de lignes.

DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge les signets pour l'identification des lignes de l'ensemble de lignes lorsque DBPROP_BOOKMARKS ou DBPROP_LITERALBOOKMARKS a la valeur VARIANT_TRUE.

L'affectation de la valeur VARIANT_TRUE à l'une ou l'autre des propriétés ne permet pas le positionnement dans l'ensemble de lignes à partir d'un signet. Affectez VARIANT_TRUE à DBPROP_IRowsetLocate ou DBPROP_IRowsetScroll pour créer un ensemble de lignes prenant en charge le positionnement dans l'ensemble de lignes à partir d'un signet.

Le fournisseur OLE DB de SQL Server Native Client utilise un curseur Microsoft SQL Server pour prendre en charge un ensemble de lignes qui contient des signets. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

[!REMARQUE]

Tout conflit de ces propriétés avec d'autres propriétés de définition de curseur du fournisseur OLE DB de SQL Server Native Client provoque une erreur. Par exemple, si DBPROP_BOOKMARKS a la valeur VARIANT_TRUE alors que DBPROP_OTHERINSERT a également la valeur VARIANT_TRUE, une erreur est générée lorsque le consommateur essaie d'ouvrir un ensemble de lignes.

DBPROP_BOOKMARKSKIPPED

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client retourne DB_E_BADBOOKMARK si le consommateur indique un signet non valide lors du positionnement ou d'une recherche dans un ensemble de lignes contenant un signet.

DBPROP_BOOKMARKTYPE

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : DBPROPVAL_BMK_NUMERIC

Description : le fournisseur OLE DB de SQL Server Native Client implémente uniquement des signets numériques. Un signet de fournisseur OLE DB de SQL Server Native Client est un entier non signé 32 bits de type DBTYPE_UI4.

DBPROP_CACHEDEFERRED

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge l'extraction et le défilement vers l'arrière dans les ensembles de lignes non séquentiels. Le fournisseur OLE DB de SQL Server Native Client crée un ensemble de lignes pris en charge par le curseur lorsque DBPROP_CANFETCHBACKWARDS ou DBPROP_CANSCROLLBACKWARDS a la valeur VARIANT_TRUE. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

DBPROP_CANHOLDROWS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : par défaut, le fournisseur OLE DB de SQL Server Native Client retourne DB_E_ROWSNOTRELEASED si le consommateur essaie d'obtenir davantage de lignes pour un ensemble de lignes pendant que des modifications en attente existent sur les lignes se trouvant actuellement dans l'ensemble de lignes. Ce comportement peut être modifié.

L'affectation de la valeur VARIANT_TRUE à DBPROP_CANHOLDROWS et DBPROP_IRowsetChange implique un ensemble de lignes contenant un signet. Si les deux propriétés ont la valeur VARIANT_TRUE, l'interface IRowsetLocate est disponible sur l'ensemble de lignes ; par ailleurs, DBPROP_BOOKMARKS et DBPROP_LITERALBOOKMARKS ont tous les deux la valeur VARIANT_TRUE.

Les ensembles de lignes du fournisseur OLE DB de SQL Server Native Client qui contiennent des signets sont pris en charge par les curseurs SQL Server.

DBPROP_CHANGEINSERTEDROWS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : cette propriété peut être définie uniquement à VARIANT_TRUE si l'ensemble de lignes utilise un curseur de jeu de clés.

DBPROP_COLUMNRESTRICT

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client définit la propriété à VARIANT_TRUE lorsqu'une colonne d'un ensemble de lignes ne peut pas être modifiée par le consommateur. D'autres colonnes de l'ensemble de lignes peuvent être mises à jour et les lignes elles-mêmes peuvent être supprimées.

Lorsque la propriété a la valeur VARIANT_TRUE, le consommateur examine le membre dwFlags de la structure DBCOLUMNINFO pour déterminer si la valeur d'une colonne individuelle peut être écrite ou non. Pour les colonnes modifiables, dwFlags expose DBCOLUMNFLAGS_WRITE.

DBPROP_COMMANDTIMEOUT

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : 0

Description : par défaut, le fournisseur OLE DB de SQL Server Native Client n'a pas de délai d'attente pour la méthode ICommand::Execute.

DBPROP_COMMITPRESERVE

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le comportement d'un ensemble de lignes après une opération de validation est déterminé par cette propriété.

VARIANT_TRUE : le fournisseur OLE DB de SQL Server Native Client conserve un ensemble de lignes valide.

VARIANT_FALSE : le fournisseur OLE DB de SQL Server Native Client invalide les ensembles de lignes après une opération de validation. Les fonctionnalités de l'objet d'ensemble de lignes sont quasiment perdues. Seules les opérations IUnknown et la libération des handles de ligne et d'accesseur en attente sont prises en charge.

DBPROP_DEFERRED

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : si la valeur est VARIANT_TRUE, le fournisseur OLE DB de SQL Server Native Client essaie d'utiliser un curseur côté serveur pour l'ensemble de lignes. Les colonnes text, ntext et image ne sont pas retournées par le serveur tant qu'elles ne sont pas accessibles à l'application.

DBPROP_DELAYSTORAGEOBJECTS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge le mode de mise à jour immédiate sur les objets de stockage.

Les modifications apportées aux données dans un objet de flux séquentiel sont immédiatement envoyées à SQL Server. Les modifications sont validées selon le mode de transaction de l'ensemble de lignes.

DBPROP_HIDDENCOLUMNS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : nombre de colonnes masquées.

Si DBPROP_UNIQUEROWS a la valeur VARIANT_TRUE, la propriété DBPROP_HIDDENCOLUMNS retourne le nombre de colonnes « cachées » supplémentaires ajoutées par le fournisseur pour identifier les lignes de manière unique dans l'ensemble de lignes. Ces colonnes sont retournées par IColumnsInfo::GetColumnInfo et IColumnsRowset::GetColumnsRowset. Toutefois, elles ne sont pas incluses dans le nombre de lignes retourné par l'argument pcColumns, qui est retourné par IColumnsInfo::GetColumnInfo.

Pour déterminer le nombre total de colonnes représentées dans la structure prgInfo retournée par IColumnsInfo::GetColumnInfo, y compris les colonnes masquées, le consommateur ajoute la valeur de DBPROP_HIDDENCOLUMNS au nombre de colonnes retourné par IColumnsInfo::GetColumnInfo dans pcColumns. Si DBPROP_UNIQUEROWS a la valeur VARIANT_FALSE, DBPROP_HIDDENCOLUMNS a la valeur zéro.

DBPROP_IAccessor DBPROP_IColumnsInfo DBPROP_IConvertType DBPROP_IRowset DBPROP_IRowsetInfo

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge ces interfaces sur tous les ensembles de lignes.

DBPROP_IColumnsRowset

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_TRUE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge l'interface IColumnsRowset.

DBPROP_IConnectionPointContainer

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : IConnectionPointContainer. Si la valeur est VARIANT_TRUE, l'ensemble de lignes prend en charge l'interface spécifiée. Si la valeur est VARIANT_FALSE, l'ensemble de lignes ne prend pas en charge l'interface spécifiée. Les fournisseurs qui prennent en charge une interface doivent prendre en charge la propriété associée à cette interface avec une valeur VARIANT_TRUE. Ces propriétés sont essentiellement utilisées pour adresser des requêtes aux interfaces via ICommandProperties::SetProperties.

DBPROP_IMultipleResults

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge l'interface IMultipleResults.

DBPROP_IRowsetChange DBPROP_IRowsetUpdate

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge les interfaces IRowsetChange et IRowsetUpdate.

Un ensemble de lignes créé en utilisant DBPROP_IRowsetChange avec la valeur VARIANT_TRUE expose les comportements du mode de mise à jour immédiate.

Lorsque DBPROP_IRowsetUpdate a la valeur VARIANT_TRUE, DBPROP_IRowsetChange a également la valeur VARIANT_TRUE. L'ensemble de lignes expose le comportement du mode de mise à jour différée.

Le fournisseur OLE DB de SQL Server Native Client utilise un curseur SQL Server pour prendre en charge les ensembles de lignes exposant IRowsetChange ou IRowsetUpdate. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

DBPROP_IRowsetIdentity

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_TRUE

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge l'interface IRowsetIdentity. Si un ensemble de lignes prend en charge cette interface, deux handles de ligne représentant la même ligne sous-jacente reflètent toujours les mêmes données et le même état. Les consommateurs peuvent appeler la méthode IRowsetIdentity:: IsSameRow pour comparer deux handles de ligne et déterminer s'ils font référence à la même instance de ligne.

DBPROP_IRowsetLocate DBPROP_IRowsetScroll

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client peut exposer les interfaces IRowsetLocate et IRowsetScroll.

Lorsque DBPROP_IRowsetLocate a la valeur VARIANT_TRUE, DBPROP_CANFETCHBACKWARDS et DBPROP_CANSCROLLBACKWARDS ont également la valeur VARIANT_TRUE.

Lorsque DBPROP_IRowsetScroll a la valeur VARIANT_TRUE, DBPROP_IRowsetLocate a également la valeur VARIANT_TRUE ; en outre, les deux interfaces sont disponibles dans l'ensemble de lignes.

Les signets sont requis pour les deux interfaces. Le fournisseur OLE DB de SQL Server Native Client définit DBPROP_BOOKMARKS et DBPROP_LITERALBOOKMARKS à VARIANT_TRUE lorsque le consommateur demande l'une ou l'autre des interfaces.

Le fournisseur OLE DB de SQL Server Native Client utilise des curseurs SQL Server pour prendre en charge IRowsetLocate et IRowsetScroll. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

Tout conflit de ces propriétés avec d'autres propriétés de définition de curseur du fournisseur OLE DB de SQL Server Native Client provoque une erreur. Par exemple, si DBPROP_IRowsetScroll a la valeur VARIANT_TRUE alors que DBPROP_OTHERINSERT a également la valeur VARIANT_TRUE, une erreur est générée lorsque le consommateur essaie d'ouvrir un ensemble de lignes.

DBPROP_IRowsetResynch

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client expose l'interface IRowsetResynch à la demande. Le fournisseur OLE DB de SQL Server Native Client peut exposer l'interface sur n'importe quel ensemble de lignes.

DBPROP_ISupportErrorInfo

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_TRUE

Description : le fournisseur OLE DB de SQL Server Native Client expose l'interface ISupportErrorInfo sur les ensembles de lignes.

DBPROP_ILockBytes

Cette interface n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la propriété génère une erreur.

DBPROP_ISequentialStream

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client expose l'interface ISequentialStream pour prendre en charge les données de longueur variable de type Long stockées dans SQL Server.

DBPROP_IStorage

Cette interface n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la propriété génère une erreur.

DBPROP_IStream

Cette interface n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la propriété génère une erreur.

DBPROP_IMMOBILEROWS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_TRUE

Description : la propriété a uniquement la valeur VARIANT_TRUE pour les curseurs de jeu de clés SQL Server. Elle a la valeur VARIANT_FALSE pour tous les autres curseurs.

VARIANT_TRUE : l'ensemble de lignes ne réorganise pas les lignes insérées ou mises à jour. Pour IRowsetChange::InsertRow, les lignes apparaissent à la fin de l'ensemble de lignes. Pour IRowsetChange::SetData, si l'ensemble de lignes n'est pas ordonné, la position des lignes mises à jour n'est pas modifiée. Si l'ensemble de lignes est ordonné et si IRowsetChange::SetData modifie une colonne utilisée pour ordonner l'ensemble de lignes, la ligne n'est pas déplacée. Si l'ensemble de lignes est basé sur un jeu de colonnes clés (en général, un ensemble de lignes pour lequel DBPROP_OTHERUPDATEDELETE a la valeur VARIANT_TRUE mais où DBPROP_OTHERINSERT a la valeur VARIANT_FALSE), la modification de la valeur d'une colonne clé est généralement équivalente à la suppression de la ligne actuelle et à l'insertion d'une nouvelle ligne. Par conséquent, la ligne peut se déplacer, voire disparaître, dans l'ensemble de lignes, si DBPROP_OWNINSERT a la valeur VARIANT_FALSE, alors que la propriété DBPROP_IMMOBILEROWS a la valeur VARIANT_TRUE.

VARIANT_FALSE : si l'ensemble de lignes est ordonné, les lignes insérées apparaissent dans l'ordre approprié de l'ensemble de lignes. Si l'ensemble de lignes n'est pas ordonné, la ligne insérée apparaît à la fin. Si IRowsetChange::SetData modifie une colonne utilisée pour ordonner l'ensemble de lignes, la ligne est déplacée. Si l'ensemble de lignes n'est pas ordonné, la position de la ligne ne change pas.

DBPROP_LITERALIDENTITY

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : cette propriété a toujours la valeur VARIANT_TRUE.

DBPROP_LOCKMODE

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : DBPROPVAL_LM_NONE

Description : niveau du verrouillage effectué par l'ensemble de lignes (DBPROPVAL_LM_NONE, DBPROPVAL_LM_SINGLEROW).

[!REMARQUE]

Lors de l'utilisation du niveau d'isolement d'instantané dans une transaction, si un ensemble de lignes est ouvert via un curseur de jeu de clés ou un curseur côté serveur dynamique et si le mode de verrouillage a la valeur DBPROPVAL_LM_SINGLEROW, une erreur se produit lors de l'extraction d'une ligne qui a été mise à jour par une autre personne depuis le début de la transaction. Pour les autres types de curseurs et modes de verrouillage, si une autre personne a mis à jour la ligne depuis le début de la transaction, aucune erreur ne se produit tant que l'utilisateur n'essaie pas de mettre à jour cette ligne. Dans les deux cas, ces erreurs sont générées par le serveur.

DBPROP_MAXOPENROWS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : 0

Description : le fournisseur OLE DB de SQL Server Native Client ne limite pas le nombre des lignes qui peuvent être actives dans les ensembles de lignes.

DBPROP_MAXPENDINGROWS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : 0

Description : le fournisseur OLE DB de SQL Server Native Client ne limite pas le nombre de lignes d'ensemble de lignes avec des modifications en attente.

DBPROP_MAXROWS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : 0

Description : par défaut, le fournisseur OLE DB de SQL Server Native Client ne limite pas le nombre de lignes dans un ensemble de lignes. Lorsque le consommateur définit DBPROP_MAXROWS, le fournisseur OLE DB de SQL Server Native Client utilise l'instruction SET ROWCOUNT pour limiter le nombre de lignes dans l'ensemble de lignes.

SET ROWCOUNT peut avoir des conséquences inattendues dans l'exécution de l'instruction SQL Server. Pour plus d'informations, consultez SET ROWCOUNT.

DBPROP_MAYWRITECOLUMN

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_MEMORYUSAGE

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_NOTIFICATIONGRANULARITY

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_NOTIFICATIONPHASES

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge toutes les phases de notification.

DBPROP_NOTIFYCOLUMNSET DBPROP_NOTIFYROWDELETE DBPROP_NOTIFYROWFIRSTCHANGE DBPROP_NOTIFYROWINSERT DBPROP_NOTIFYROWRESYNCH DBPROP_NOTIFYROWSETRELEASE DBPROP_NOTIFYROWSETFETCH-POSITIONCHANGE DBPROP_NOTIFYROWUNDOCHANGE DBPROP_NOTIFYROWUNDODELETE DBPROP_NOTIFYROWUNDOINSERT DBPROP_NOTIFYROWUPDATE

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO

Description : les phases de notification du fournisseur OLE DB de SQL Server Native Client peuvent être annulées avant toute tentative d'exécution de la modification spécifiée de l'ensemble de lignes. Le fournisseur OLE DB de SQL Server Native Client ne prend pas en charge l'annulation de phase une fois la tentative effectuée.

DBPROP_ORDEREDBOOKMARKS

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_OTHERINSERT DBPROP_OTHERUPDATEDELETE DBPROP_OWNINSERT DBPROP_OWNUPDATEDELETE

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : la définition de propriétés de visibilité des modifications oblige le fournisseur OLE DB de SQL Server Native Client à utiliser des curseurs SQL Server pour prendre en charge l'ensemble de lignes. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

DBPROP_QUICKRESTART

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : si la valeur est VARIANT_TRUE, le fournisseur OLE DB de SQL Server Native Client essaie d'utiliser un curseur côté serveur pour l'ensemble de lignes.

DBPROP_REENTRANTEVENTS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : les ensembles de lignes du fournisseur OLE DB de SQL Server Native Client sont réentrants et peuvent retourner DB_E_NOTREENTRANT si un consommateur essaie d'accéder à une méthode d'ensemble de lignes non réentrante à partir d'un rappel de notification.

DBPROP_REMOVEDELETED

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client modifie la valeur de la propriété en fonction de la visibilité des modifications apportées aux données SQL Server exposées par l'ensemble de lignes.

VARIANT_TRUE : les lignes supprimées par le consommateur ou d'autres utilisateurs SQL Server sont supprimées de l'ensemble de lignes lorsque ce dernier est actualisé. DBPROP_OTHERINSERT a la valeur VARIANT_TRUE.

VARIANT_FALSE : les lignes supprimées par le consommateur ou d'autres utilisateurs SQL Server ne sont pas supprimées de l'ensemble de lignes lorsque ce dernier est actualisé. La valeur d'état de ligne pour les lignes SQL Server supprimées dans l'ensemble de lignes est DBROWSTATUS_E_DELETED. DBPROP_OTHERINSERT a la valeur VARIANT_TRUE.

Cette propriété a seulement une valeur pour les ensembles de lignes pris en charge par les curseurs SQL Server. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

Lorsque la propriété DBPROP_REMOVEDELETED est implémentée dans l'ensemble de lignes d'un curseur de jeu de clés, les lignes supprimées sont enlevées au moment de l'extraction ; par ailleurs, les méthodes d'extraction de lignes, telles que GetNextRows et GetRowsAt peuvent retourner S_OK et moins de lignes que prévu. Notez que ce comportement ne correspond pas à la condition DB_S_ENDOFROWSET et que le nombre de lignes retournées ne peut jamais être nul s'il reste des lignes.

DBPROP_REPORTMULTIPLECHANGES

Cette propriété d'ensemble de lignes n'est pas implémentée par le fournisseur OLE DB de SQL Server Native Client. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur.

DBPROP_RETURNPENDINGINSERTS

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : lorsqu'une méthode qui extrait des lignes est appelée, le fournisseur OLE DB de SQL Server Native Client ne retourne pas les lignes en attente d'insertion.

DBPROP_ROWRESTRICT

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : les ensembles de lignes du fournisseur OLE DB de SQL Server Native Client ne prennent pas en charge les droits d'accès en fonction de la ligne. Si l'interface IRowsetChange est exposée sur un ensemble de lignes, la méthode SetData peut être appelée par le consommateur.

DBPROP_ROWSET_ASYNCH

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : 0

Description : permet le traitement asynchrone de l'ensemble de lignes. Cette propriété figure dans le groupe de propriétés d'ensemble de lignes et dans le jeu de propriétés DBPROPSET_ROWSET. Le type est VT_14.

La seule valeur du masque de bits prise en charge par SQL Server Native Client est DBPROPVAL_ASYNCH_INITIALIZE.

DBPROP_ROWTHREADMODEL

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : DBPROPVAL_RT_FREETHREAD

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge l'accès à ses objets à partir de plusieurs threads d'exécution d'un consommateur unique.

DBPROP_SERVERCURSOR

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : une fois la propriété définie, un curseur SQL Server est utilisé pour prendre en charge l'ensemble de lignes. Pour plus d'informations, consultez Ensembles de lignes et curseurs SQL Server.

DBPROP_SERVERDATAONINSERT

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : données du serveur lors de l'insertion.

VARIANT_TRUE : au moment où une insertion est transmise au serveur, le fournisseur récupère les données du serveur afin de mettre à jour le cache de lignes local.

VARIANT_FALSE : le fournisseur ne récupère pas les valeurs du serveur pour les lignes récemment insérées.

DBPROP_STRONGIDENTITY

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_TRUE

Description : identité de ligne forte. Si les insertions sont autorisées dans un ensemble de lignes (IRowsetChange ou IRowsetUpdate a la valeur true), et si DBPROP_UPDATABILITY est défini pour prendre en charge InsertRows, la valeur de DBPROP_STRONGIDENTITY dépend de la propriété DBPROP_CHANGEINSERTEDROWS (VARIANT_FALSE, si la valeur de propriété de DBPROP_CHANGEINSERTEDROWS est VARIANT_FALSE).

DBPROP_TRANSACTEDOBJECT

L/E (Lecture/Écriture) : lecture seule

Valeur par défaut : VARIANT_FALSE

Description : le fournisseur OLE DB de SQL Server Native Client prend uniquement en charge les objets transactionnels. Pour plus d'informations, consultez Transactions.

DBPROP_UNIQUEROWS

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : VARIANT_FALSE

Description : lignes uniques.

VARIANT_TRUE : chaque ligne est identifiée uniquement par ses valeurs de colonnes. Pour le jeu des colonnes qui identifient la ligne de manière unique, DBCOLUMNFLAGS_KEYCOLUMN est défini dans la structure DBCOLUMNINFO retournée par la méthode GetColumnInfo.

VARIANT_FALSE : les lignes peuvent être identifiées ou non de manière unique par leurs valeurs de colonnes. Les colonnes clés peuvent être signalées ou non à l'aide de DBCOLUMNFLAGS_KEYCOLUMN.

DBPROP_UPDATABILITY

L/E (Lecture/Écriture) : lecture/écriture

Valeur par défaut : 0

Description : le fournisseur OLE DB de SQL Server Native Client prend en charge toutes les valeurs de DBPROP_UPDATABILITY. La définition de DBPROP_UPDATABILITY ne crée pas d'ensemble de lignes modifiable. Pour rendre un ensemble de lignes modifiable, définissez DBPROP_IRowsetChange ou DBPROP_IRowsetUpdate.

Le fournisseur OLE DB de SQL Server Native Client définit le jeu de propriétés DBPROPSET_SQLSERVERROWSET spécifique au fournisseur, comme illustré dans ce tableau.

Identifiant de la propriété

Description

SSPROP_COLUMN_ID

Colonne : ColumnID

L/E (Lecture/Écriture) : lecture seule

Type : VT_U12 | VT_ARRAY

Valeur par défaut : VT_EMPTY

Description : tableau de valeurs entières représentant la position ordinale (de base 1) d'une colonne de résultats d'une clause COMPUTE dans l'instruction Transact-SQL SELECT actuelle. Il s'agit de l'équivalent pour le fournisseur OLE DB de SQL Server Native Client de l'attribut ODBC SQL_CA_SS_COLUMN_ID.

SSPROP_DEFERPREPARE

Colonne : non

L/E : lecture/écriture

Type : VT_BOOL

Valeur par défaut : VARIANT_TRUE

Description : VARIANT_TRUE : dans l'exécution préparée, la préparation de la commande est différée jusqu'à ce que ICommand::Execute soit appelé ou qu'une opération de métapropriété soit effectuée. Si la propriété a la valeur

VARIANT_FALSE : l'instruction est préparée lorsque ICommandPrepare::Prepare est exécuté.

SSPROP_IRowsetFastLoad

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_BOOL

Valeur par défaut : VARIANT_FALSE

Description : définissez cette propriété à VARIANT_TRUE pour ouvrir un ensemble de lignes à chargement rapide via IOpenRowset::OpenRowset. Vous ne pouvez pas définir cette propriété dans ICommandProperties::SetProperties.

SSPROP_ISSAsynchStatus

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_BOOL

Valeur par défaut : VARIANT_FALSE

Description : définissez cette propriété à VARIANT_TRUE pour activer les opérations asynchrones à l'aide de l'interface ISSAsynchStatus.

SSPROP_MAXBLOBLENGTH

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_I4

Valeur par défaut : le fournisseur ne restreint pas la taille du texte retourné par le serveur et la valeur de propriété est définie à sa valeur maximale. Par exemple 2 147 483 647.

Description : le fournisseur OLE DB de SQL Server Native Client exécute une instruction SET TEXTSIZE pour restreindre la longueur des données d'objet BLOB (Binary Large Object) retournées dans une instruction SELECT.

SSPROP_NOCOUNT_STATUS

Colonne : NoCount

L/E (Lecture/Écriture) : lecture seule

Type : VT_BOOL

Valeur par défaut : VARIANT_FALSE

Description : valeur booléenne représentant l'état de SET NOCOUNT ON/OFF dans SQL Server :

VARIANT_TRUE : avec SET NOCOUNT ON

VARIANT_FALSE : avec SET NOCOUNT OFF

SSPROP_QP_NOTIFICATION_MSGTEXT

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_BSTR (entre 1 et 2 000 caractères sont autorisés)

Valeur par défaut : chaîne vide

Description : texte du message de notification de requête. Il est défini par l'utilisateur et n'a aucun format spécifique.

SSPROP_QP_NOTIFICATION_OPTIONS

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_BSTR

Valeur par défaut : chaîne vide

Description : options de notifications de requêtes. Elles sont spécifiées dans une chaîne avec name=value. L'utilisateur est chargé de créer le service et de lire les notifications de la file d'attente. La syntaxe de la chaîne des options de notifications de requêtes est :

service=<service-name>[;(local database=<database>|broker instance=<broker instance>)]

Exemple :

service=mySSBService;local database=mydb

SSPROP_QP_NOTIFICATION_TIMEOUT

Colonne : non

L/E (Lecture/Écriture) : lecture/écriture

Type : VT_UI4

Valeur par défaut : 432 000 secondes (5 jours)

Valeur minimale : 1 seconde

Valeur maximale : 2^31-1 secondes

Description : nombre de secondes pendant lesquelles la notification de requête doit rester active.

Voir aussi

Concepts

ensembles de lignes