Propriétés et comportements de l'ensemble de lignes
S’applique à : 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
Il s’agit des propriétés d’ensemble de lignes OLE DB Driver pour SQL Server.
| ID de propriété | Description |
|---|---|
| DBPROP_ABORTPRESERVE | R/W : 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 : OLE DB Driver pour SQL Server 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 descripteurs de ligne et d’accesseur en attente sont prises en charge. VARIANT_TRUE : OLE DB Driver pour SQL Server gère un ensemble de lignes valide. |
| DBPROP_ACCESSORDER | R/W : 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: La colonne est accessible 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 OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur. |
| DBPROP_BLOCKINGSTORAGEOBJECTS | R/W : Lecture seule Valeur par défaut : VARIANT_TRUE Description : Les objets de stockage OLE DB Driver pour SQL Server bloquent l’utilisation d’autres méthodes d’ensemble de lignes. |
| DBPROP_BOOKMARKS DBPROP_LITERALBOOKMARKS | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server 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 Driver pour SQL Server 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 pilote OLE DB pour SQL Server 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 | R/W : Lecture seule Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server 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 | R/W : Lecture seule Valeur par défaut : DBPROPVAL_BMK_NUMERIC Description : OLE DB Driver pour SQL Server implémente uniquement les signets numériques. Un signet OLE DB Driver pour SQL Server est un entier non signé de 32 bits de type DBTYPE_UI4. |
| DBPROP_CACHEDEFERRED | Cette propriété d’ensemble de lignes n’est pas implémentée par OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur. |
| DBPROP_CANFETCHBACKWARDS DBPROP_CANSCROLLBACKWARDS | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server prend en charge l'extraction et le défilement vers l'arrière dans les ensembles de lignes non séquentiels. Le pilote OLE DB pour SQL Server 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Par défaut, OLE DB Driver pour SQL Server retourne DB_E_ROWSNOTRELEASED si le contrôle serveur consommateur essaie d’obtenir davantage de lignes pour un ensemble de lignes alors que des modifications sont en attente pour les lignes actuellement dans cet ensemble. 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 Driver pour SQL Server qui contiennent des signets sont pris en charge par les curseurs SQL Server. |
| DBPROP_CHANGEINSERTEDROWS | R/W : 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 | R/W : Lecture seule Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server définit la propriété sur 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 | R/W : Lecture/écriture Valeur par défaut : 0 Description : Par défaut,OLE DB Driver pour SQL Server n’expire pas sur la méthode ICommand::Execute. |
| DBPROP_COMMITPRESERVE | R/W : 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 : OLE DB Driver pour SQL Server gère un ensemble de lignes valide. VARIANT_FALSE : OLE DB Driver pour SQL Server 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 descripteurs de ligne et d’accesseur en attente sont prises en charge. |
| DBPROP_DEFERRED | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Si la valeur est VARIANT_TRUE, le fournisseur OLE DB Driver pour SQL Server 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 | R/W : Lecture seule Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server 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 | R/W : 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 | R/W : Lecture seule Valeur par défaut : VARIANT_TRUE Description : OLE DB Driver pour SQL Server prend en charge ces interfaces sur tous les ensembles de lignes. |
| DBPROP_IColumnsRowset | R/W : Lecture/écriture Valeur par défaut : VARIANT_TRUE Description : OLE DB Driver pour SQL Server prend en charge l’interface IColumnsRowset. |
| DBPROP_IConnectionPointContainer | R/W : 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server prend en charge l’interface IMultipleResults. |
| DBPROP_IRowsetChange DBPROP_IRowsetUpdate | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server prend en charge les interfaces IRowsetChange et IRowsetUpdate. 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. 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 Driver pour SQL Server 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_TRUE Description : OLE DB Driver pour SQL Server 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 descripteurs de ligne et déterminer s’ils font référence à la même instance de ligne. |
| DBPROP_IRowsetLocate DBPROP_IRowsetScroll | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server 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 pilote OLE DB pour SQL Server définit DBPROP_BOOKMARKS et DBPROP_LITERALBOOKMARKS à VARIANT_TRUE lorsque le consommateur demande l’une ou l’autre des interfaces. OLE DB Driver pour SQL Server 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 pilote OLE DB pour SQL Server 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server expose l’interface IRowsetResynch à la demande. OLE DB Driver pour SQL Server peut exposer l’interface sur n’importe quel ensemble de lignes. |
| DBPROP_ISupportErrorInfo | R/W : Lecture/écriture Valeur par défaut : VARIANT_TRUE Description : OLE DB Driver pour SQL Server expose l’interface ISupportErrorInfo sur les ensembles de lignes. |
| DBPROP_ILockBytes | Cette interface n’est pas implémentée par OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la propriété génère une erreur. |
| DBPROP_ISequentialStream | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server 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 OLE DB Driver pour SQL Server. 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 OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la propriété génère une erreur. |
| DBPROP_IMMOBILEROWS | R/W : 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 | R/W : Lecture seule Valeur par défaut : VARIANT_TRUE Description : Cette propriété a toujours la valeur VARIANT_TRUE. |
| DBPROP_LOCKMODE | R/W : 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’isolation 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 la récupération (fetch) 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 | R/W : Lecture seule Valeur par défaut : 0 Description : OLE DB Driver pour SQL Server ne limite pas le nombre des lignes qui peuvent être actives dans les ensembles de lignes. |
| DBPROP_MAXPENDINGROWS | R/W : Lecture seule Valeur par défaut : 0 Description : OLE DB Driver pour SQL Server ne limite pas le nombre de lignes d'ensemble de lignes avec des modifications en attente. |
| DBPROP_MAXROWS | R/W : Lecture/écriture Valeur par défaut : 0 Description : Par défaut, OLE DB Driver pour SQL Server ne limite pas le nombre de lignes dans un ensemble de lignes. Lorsque le consommateur définit DBPROP_MAXROWS, le pilote OLE DB pour SQL Server 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 OLE DB Driver pour SQL Server. 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 OLE DB Driver pour SQL Server. 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 OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur. |
| DBPROP_NOTIFICATIONPHASES | R/W : Lecture seule Valeur par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO | DBPROPVAL_NP_SYNCHAFTER | DBPROPVAL_NP_FAILEDTODO | DBPROPVAL_NP_DIDEVENT Description : OLE DB Driver pour SQL Server 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 | R/W : Lecture seule Valeur par défaut : DBPROPVAL_NP_OKTODO | DBPROPVAL_NP_ABOUTTODO Description : Les phases de notification du pilote OLE DB pour SQL Server 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 Driver pour SQL Server 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 OLE DB Driver pour SQL Server. 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : La définition des propriétés de visibilité des modifications oblige le pilote OLE DB pour SQL Server à 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Si la valeur est VARIANT_TRUE, le fournisseur OLE DB Driver pour SQL Server essaie d'utiliser un curseur côté serveur pour l'ensemble de lignes. |
| DBPROP_REENTRANTEVENTS | R/W : Lecture seule Valeur par défaut : VARIANT_TRUE Description : Les ensembles de lignes du pilote OLE DB pour SQL Server 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 | R/W : Lecture/écriture Valeur par défaut : VARIANT_FALSE Description : Le pilote OLE DB pour SQL Server 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 la récupération (fetch). Par ailleurs, les méthodes de récupération 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 OLE DB Driver pour SQL Server. Toute tentative de lecture ou d'écriture de la valeur de propriété génère une erreur. |
| DBPROP_RETURNPENDINGINSERTS | R/W : Lecture seule Valeur par défaut : VARIANT_FALSE Description : Lorsqu’une méthode qui récupère (fetch) des lignes est appelée, le pilote OLE DB pour SQL Server ne retourne pas les lignes en attente d’insertion. |
| DBPROP_ROWRESTRICT | R/W : Lecture seule Valeur par défaut : VARIANT_TRUE Description : Les ensembles de lignes OLE DB Driver pour SQL Server ne prennent pas en charge les droits d’accès basés sur 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 | R/W : 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 dans le masque de bits prise en charge par OLE DB Driver pour SQL Server est DBPROPVAL_ASYNCH_INITIALIZE. |
| DBPROP_ROWTHREADMODEL | R/W : Lecture seule Valeur par défaut : DBPROPVAL_RT_FREETHREAD Description : Le pilote OLE DB pour SQL Server prend en charge l’accès à ses objets à partir de plusieurs threads d’exécution d’un même consommateur. |
| DBPROP_SERVERCURSOR | R/W : 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 | R/W : 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 | R/W : 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 | R/W : Lecture seule Valeur par défaut : VARIANT_FALSE Description : OLE DB Driver pour SQL Server prend en charge uniquement les objets transactionnels. Pour plus d’informations, consultez Transactions. |
| DBPROP_UNIQUEROWS | R/W : 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 | R/W : Lecture/écriture Valeur par défaut : 0 Description : OLE DB Driver pour SQL Server prend en charge toutes les valeurs 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 pilote OLE DB pour SQL Server définit le jeu de propriétés DBPROPSET_SQLSERVERROWSET spécifique au fournisseur, comme illustré dans ce tableau.
| ID de propriété | Description |
|---|---|
| SSPROP_COLUMN_ID | Colonne : ColumnID R/W : 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 Driver pour SQL Server de l'attribut ODBC SQL_CA_SS_COLUMN_ID. |
| SSPROP_DEFERPREPARE | Colonne : Non R/W : Lecture/écriture Tapez : 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 R/W : Lecture/écriture Tapez : VT_BOOL Valeur par défaut : VARIANT_FALSE Description : Définissez cette propriété sur 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. R/W : Lecture/écriture Tapez : VT_BOOL Valeur par défaut : VARIANT_FALSE Description : Définissez cette propriété sur VARIANT_TRUE pour activer les opérations asynchrones à l’aide de l’interface ISSAsynchStatus. |
| SSPROP_ISSDataClassification | R/W : Lecture/écriture Tapez : VT_BOOL Valeur par défaut : VARIANT_TRUE Description : OLE DB Driver pour SQL Server prend en charge la récupération des informations de classification de sensibilité à l’aide de l’interface ISSDataClassification . |
| SSPROP_MAXBLOBLENGTH | Colonne : Non R/W : Lecture/écriture Tapez : 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 pilote OLE DB pour SQL Server 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 R/W : Lecture seule Tapez : 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 R/W : Lecture/écriture Tapez : 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 R/W : Lecture/écriture Tapez : VT_BSTR Valeur par défaut : Chaîne vide Description : Options de notification 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>)]Par exemple : service=mySSBService;local database=mydb |
| SSPROP_QP_NOTIFICATION_TIMEOUT | Colonne : Non R/W : Lecture/écriture Tapez : VT_UI4 Valeur par défaut : 432000 secondes (5 jours) Minimum : 1 seconde Maximum : 2^31-1 secondes Description : Nombre de secondes pendant lesquelles la notification de requête doit rester active. |