OdbcConnection.ConnectionString Propriété

Définition

Espace de noms:

System.Data.Odbc

Assembly:

System.Data.Odbc.dll

Paquet:

System.Data.Odbc v8.0.0

Source:

OdbcConnection.cs

Obtient ou définit la chaîne utilisée pour ouvrir une source de données.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Valeur de propriété

String

Chaîne de connexion du pilote ODBC qui comprend des paramètres, tels que le nom de la source de données, requis pour établir la connexion initiale. La valeur par défaut est une chaîne vide (""). La longueur maximale est de 1024 caractères.

Remarques

La ConnectionString propriété est conçue pour correspondre au format odbc chaîne de connexion aussi étroitement que possible. Le ConnectionString ne peut être défini que lorsque la connexion est fermée et, dès qu’elle est définie, elle est passée, inchangée, au Gestionnaire de pilotes et au pilote sous-jacent. Par conséquent, la syntaxe du ConnectionString doit correspondre exactement à ce que le Gestionnaire de pilotes et le pilote sous-jacent prennent en charge.

Vous pouvez utiliser la ConnectionString propriété pour vous connecter à diverses sources de données. Cela inclut un nom de source de données ODBC (DSN). L’exemple suivant illustre plusieurs chaînes de connexion possibles.

"Driver={SQL Server};Server=(local);Trusted_Connection=Yes;Database=AdventureWorks;"

"Driver={Microsoft ODBC for Oracle};Server=ORACLE8i7;Persist Security Info=False;Trusted_Connection=Yes"

"Driver={Microsoft Access Driver (*.mdb)};DBQ=c:\bin\Northwind.mdb"

"Driver={Microsoft Excel Driver (*.xls)};DBQ=c:\bin\book1.xls"

"Driver={Microsoft Text Driver (*.txt; *.csv)};DBQ=c:\bin"

"DSN=dsnname"

Notes

Le fournisseur de données .NET Framework pour ODBC ne prend pas en charge le Persist Security Info mot clé pris en charge par d’autres fournisseurs de données .NET Framework. Toutefois, la ConnectionString propriété se comporte comme si Persist Security Info elle avait la valeur false. Cela signifie que vous ne pouvez pas récupérer le mot de passe de la ConnectionString propriété si la connexion a été ouverte. Lorsque la ConnectionString propriété est lue à partir d’un OdbcConnection objet qui a été ouvert, le chaîne de connexion est retourné moins le mot de passe. Vous ne pouvez pas modifier ce comportement ; par conséquent, si l’application nécessite le mot de passe, stockez-le séparément avant d’appeler Open.

La plupart des paramètres spécifiés dans la chaîne ont des propriétés en lecture seule correspondantes (par exemple, Server=(local), qui correspond à la DataSource propriété ). Ces propriétés sont mises à jour après l’ouverture de la connexion, sauf lorsqu’une erreur est détectée. Dans ce cas, aucune des propriétés n’est mise à jour. OdbcConnectionpropriétés (telles que Database) retournent uniquement les paramètres par défaut ou ceux spécifiés dans .ConnectionString

Dans Microsoft .NET Framework version 1.0, la validation de la chaîne de connexion ne se produit pas tant qu’une application n’appelle pas la Open méthode. Il incombe au pilote ODBC sous-jacent de valider les chaîne de connexion. Si le chaîne de connexion contient des propriétés non valides ou non prises en charge, le pilote peut déclencher une au moment de l’exécutionOdbcException.

Toutefois, dans .NET Framework version 1.1 et versions ultérieures, une validation de base du chaîne de connexion se produit dès que vous définissez la ConnectionString propriété. À ce moment-là, le fournisseur de données vérifie que le chaîne de connexion répond à la valeur « mot clé=value ;... » format, mais il ne vérifie pas si les mots clés ou les valeurs sont valides. La vérification restante est effectuée par le pilote ODBC sous-jacent lorsque l’application appelle la Open méthode.

Un chaîne de connexion ODBC a la syntaxe suivante :

connection-string ::= empty-string[;] | attribute[;] | attribute; connection-string
empty-string ::=
attribute ::= attribute-keyword=attribute-value | DRIVER=[{]attribute-value[}]
attribute-keyword ::= DSN | UID | PWD
 | driver-defined-attribute-keyword
attribute-value ::= character-string
driver-defined-attribute-keyword ::= identifier

où character-string a zéro ou plusieurs caractères ; identifier a un ou plusieurs caractères ; attribute-keyword ne respecte pas la casse ; attribute-value peut respecter la casse ; et la valeur du DSN mot clé ne se compose pas uniquement de vides.

En raison de chaîne de connexion et de la grammaire du fichier d’initialisation, il convient d’éviter les mots clés et les valeurs d’attribut qui contiennent les caractères []{}() ;? *= !@ non entouré d’accolades. La valeur du DSN mot clé ne peut pas se composer uniquement de vides et ne doit pas contenir de blancs de début. En raison de la grammaire des informations système, les mots clés et les noms de source de données ne peuvent pas contenir le caractère barre oblique inverse (\).

Les applications n’ont pas besoin d’ajouter d’accolades autour de la valeur de l’attribut après l’mot clé de pilote, sauf si l’attribut contient un point-virgule (;), auquel cas les accolades sont requises. Si la valeur d’attribut que le pilote reçoit inclut des accolades, le pilote ne doit pas les supprimer, mais elles doivent faire partie de la chaîne de connexion retournée.

Valeur DSN ou chaîne de connexion entourée d’accolades ({}) qui contient l’un des caractères []{}(), ;? *= !@ est transmis intact au pilote. Toutefois, lorsque vous utilisez ces caractères dans un mot clé, le Gestionnaire de pilotes renvoie une erreur lorsque vous travaillez avec des DSN de fichier, mais transmet le chaîne de connexion au pilote pour les chaînes de connexion régulières. Évitez d’utiliser des accolades incorporées dans une valeur mot clé.

Le chaîne de connexion peut inclure n’importe quel nombre de mots clés définis par le pilote. Étant donné que le mot clé DRIVER n’utilise pas les informations du système, le pilote doit définir suffisamment de mots clés pour qu’un pilote puisse se connecter à une source de données en utilisant uniquement les informations contenues dans le chaîne de connexion. Le pilote définit les mots clés nécessaires pour se connecter à la source de données.

Si des mots clés sont répétés dans le chaîne de connexion, il n’existe aucune garantie quant à la valeur sélectionnée.

Notes

Si un pilote ODBC prend en charge les chaînes de connexion supérieures à 1 024 caractères, vous pouvez utiliser un nom de source de données (DSN) pour dépasser la limite de longueur maximale.

Voir aussi

• Connexion à des sources de données