Share 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 source de données comme suit.

ID de propriété Description
DBPROP_CURRENTCATALOG R/W : lecture/écriture Par défaut : aucune

Description : la valeur de DBPROP_CURRENTCATALOG indique la base de données active pour une session de fournisseur OLE DB SQL Server Native Client. La définition de la valeur de la propriété a un effet identique à la définition de la base de données active avec l’instruction Transact-SQL USE database.

À compter de SQL Server 2005, si vous appelez sp_defaultdb et spécifiez le nom de la base de données en minuscules, même si la base de données a été créée à l’origine avec un nom en majuscules mixtes, DBPROP_CURRENTCATALOG renverra 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 est 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 est VARIANT_FALSE et retourne E_FAIL en cas de 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 spécifique au fournisseur DBPROPSET_SQLSERVERDATASOURCE, le SQL Server Native Client fournisseur OLE DB définit les propriétés de source de données supplémentaires suivantes.

ID de 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é est définir sue VARIANT_TRUE, l’interface IRowsetFastLoad est disponible via IOpenRowset::OpenRowset en demandant l’interface IID_IRowsetFastLoad ou en définissant SSPROP_IRowsetFastLoad sur 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.

Voir aussi

Objets source de données (OLE DB)