Propriété ConnectionString (ADO)
S’applique à : Access 2013, Office 2013
Indique les informations utilisées pour se connecter à une source de données.
Paramètres et valeurs de retour
Définit ou renvoie une valeur de type String.
Remarques
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 traitement par ADO. Les arguments pris en charge par ADO 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 de source de données persistant) contenant des informations de connexion prédéfinies. |
Remote Provider= |
Spécifie le nom d'un fournisseur à utiliser pour les connexions côté client. (Remote Data Service uniquement.) |
Remote Server= |
Spécifie le nom de chemin du serveur à utiliser pour les connexions côté client. (Remote Data Service uniquement.) |
URL= |
Spécifie la chaîne de connexion sous la forme d'une URL absolue identifiant une ressource, comme un fichier ou un répertoire. |
Une fois que vous avez 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 aux équivalents du fournisseur.
La propriété ConnectionString hérite automatiquement de la valeur utilisée pour l’argument ConnectionString de la méthode Open afin que vous puissiez remplacer la propriété ConnectionString actuelle lors de l’appel de la méthode Open.
Si vous spécifiez l'argument File Name, ADO charge le fournisseur associé. Dès lors, vous ne pouvez pas passer en même temps les arguments Provider et File Name.
La propriété ConnectionString est en lecture/écriture lorsque la connexion est fermée et en lecture seule lorsqu'elle est ouverte.
Les doublons d'un argument dans la propriété ConnectionString ne sont pas pris en compte. C'est la dernière instance de l'argument qui est utilisée.
Utilisation du service de données à distanceLorsqu’elle est utilisée sur un objet Connection côté client, la propriété ConnectionString peut inclure uniquement les paramètres Fournisseur distant et Serveur distant .