Partager via


Propriétés de la source de données (OLE DB)

Le fournisseur OLE DB SQL Server Native Client implémente les propriétés de la source de données comme suit.

Identifiant de la propriété

Description

DBPROP_CURRENTCATALOG

R/W : lecture/écriture Par défaut : aucune

Description : la valeur de DBPROP_CURRENTCATALOG signale la base de données en cours pour une session de fournisseur OLE DB SQL Server Native Client. La définition de la valeur de propriété possède un effet identique à la définition de la base de données courante en utilisant l'instruction Transact-SQL USE base_de_données.

Dans SQL Server 2005, si vous appelez sp_defaultdb et spécifiez le nom de la base de données en lettres minuscules, même si la base de données a été créée originairement avec un nom de casse mixte, DBPROP_CURRENTCATALOG retourne le nom en minuscules. Avec les versions antérieures de SQL Server, DBPROP_CURRENTCATALOG retourne la casse mixte attendue.

DBPROP_MULTIPLECONNECTIONS

R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : si la connexion exécute une commande qui ne produit pas un ensemble de lignes ou génère un ensemble de lignes qui n'est pas un curseur côté serveur et que vous exécutez une autre commande, une nouvelle connexion est créée pour exécuter la nouvelle commande si DBPROP_MULTIPLECONNECTIONS a la valeur VARIANT_TRUE.

Le fournisseur OLE DB SQL Server Native Client ne crée pas une autre connexion si DBPROP_MULTIPLECONNECTION a la valeur VARIANT_FALSE ou si une transaction est active sur la connexion. Le fournisseur OLE DB SQL Server Native Client retourne DB_E_OBJECTOPEN si DBPROP_MULTIPLECONNECTIONS a la valeur VARIANT_FALSE et E_FAIL s'il existe une transaction active. Les transactions et le verrouillage sont gérés par SQL Server connexion par connexion. Si une deuxième connexion est générée, les commandes sur les connexions séparées ne partagent pas les verrous. Pour garantir qu'une commande n'en bloque pas une autre, maintenez les verrous sur les lignes demandées par l'autre commande. Ceci reste vrai en cas de création de plusieurs sessions.

Chaque session possède une connexion distincte.

Dans le jeu de propriétés DBPROPSET_SQLSERVERDATASOURCE spécifique au fournisseur, le fournisseur OLE DB SQL Server Native Client définit les propriétés supplémentaires suivantes de la source de données.

Identifiant de la propriété

Description

SSPROP_ENABLEFASTLOAD

R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : pour permettre la copie en bloc à partir de la mémoire, la propriété SSPROP_ENABLEFASTLOAD doit avoir la valeur VARIANT_TRUE. Avec cette propriété définie sur la source de données, la session nouvellement créée autorise l'accès du consommateur à l'interface IRowsetFastLoad.

Si la propriété a la valeur VARIANT_TRUE, l'interface IRowsetFastLoad est disponible à travers IOpenRowset::OpenRowset en demandant l'interface IID_IRowsetFastLoad ou en définissant SSPROP_IRowsetFastLoad avec la valeur VARIANT_TRUE.

SSPROP_ENABLEBULKCOPY

R/W : lecture/écriture Par défaut : VARIANT_FALSE

Description : pour permettre la copie en bloc à partir de fichiers, la propriété SSPROP_ENABLEBULKCOPY doit avoir la valeur VARIANT_TRUE. Avec cette propriété définie sur la source de données, l'accès du consommateur à l'interface IBCPSession est disponible sous le même niveau que Sessions.

SSPROP_IRowsetFastLoad doit également être défini avec la valeur VARIANT_TRUE.