Partager via


ConnectionString, propriété (ADO)

Indique les informations utilisées pour établir une connexion à une source de données.

Paramètres et valeurs de retour

Définit ou retourne une valeur String.

Notes

Utilisez la propriété ConnectionString pour spécifier une source de données en transmettant une chaîne de connexion détaillée contenant une série d’instructions argument = value séparées par des points-virgules.

ADO prend en charge cinq arguments pour la propriété ConnectionString. Tous les autres arguments passent directement au fournisseur sans aucun traitement par ADO. Les arguments qu’ADO prend en charge sont les suivants.

Argument Description
Provider= Spécifie le nom d’un fournisseur à utiliser pour la connexion.
File Name= Spécifie le nom d’un fichier spécifique au fournisseur (par exemple, un objet source de données persistant) contenant des informations de connexion prédéfinies.
Remote Provider= Spécifie le nom d’un fournisseur à utiliser lors de l’ouverture d’une connexion côté client. (Remote Data Service uniquement.)
Remote Server= Spécifie le nom du chemin d’accès du serveur à utiliser lors de l’ouverture d’une connexion côté client. (Remote Data Service uniquement.)
URL= Spécifie la chaîne de connexion en tant qu’URL absolue identifiant une ressource, comme un fichier ou un répertoire.

Après avoir défini la propriété ConnectionString et ouvert l’objet Connection, le fournisseur peut modifier le contenu de la propriété, par exemple, en mappant les noms d’arguments définis par ADO à leurs équivalents pour le fournisseur spécifique.

La propriété ConnectionString héritant automatiquement de la valeur utilisée pour l’argument ConnectionString de la méthode Open, vous pouvez remplacer la propriété ConnectionString actuelle pendant l’appel de méthode Open.

Étant donné que l’argument File Name amène ADO à charger le fournisseur associé, vous ne pouvez pas passer les deux arguments Provider et File Name.

La propriété ConnectionString est en lecture/écriture quand la connexion est fermée, et en lecture seule quand elle est ouverte.

Les doublons d’un argument dans la propriété ConnectionString sont ignorés. La dernière instance de tout argument est utilisée.

Remarque

Utilisation du service de données à distance Quand elle est utilisée sur un objet Connection côté client, la propriété ConnectionString peut inclure uniquement les paramètres de Fournisseur distant et de Serveur distant.

Le tableau suivant répertorie le fournisseur ADO par défaut pour chaque système d’exploitation Windows :

Fournisseur ADO par défaut Système d’exploitation Windows
MSDASQL

(Pour améliorer la lisibilité du code source, spécifiez explicitement le nom du fournisseur dans la chaîne de connexion.)
Windows 2000 (32 bits)

Windows XP (32 bits)

Windows Server 2003 (32 bits)

Windows Vista (32 bits)

Windows Vista Service Pack 1 ou version ultérieure (32 bits et 64 bits)

Versions de Windows postérieures à Windows Vista (32 bits et 64 bits)
Aucune valeur par défaut.

Quand une application ADO s’exécute sur les systèmes d’exploitation suivants et ne spécifie pas explicitement le fournisseur, ADO retourne l’erreur suivante : « ADODB.Connection: provider is not specified and there is no designated default provider » (ADODB.Connection : le fournisseur n’est pas spécifié et aucun fournisseur par défaut n’est désigné).
Windows 2000 (64 bits)

Windows XP (64 bits)

Windows Server 2003 (64 bits)

Windows Vista (64 bits)

S’applique à

Connection, objet (ADO MD)

Voir aussi

Exemple des propriétés ConnectionString, ConnectionTimeout et State (VB)
Exemple des propriétés ConnectionString, ConnectionTimeout et State (VC++)
Annexe A : Fournisseurs