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.
|
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).
|
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. |