OdbcConnection.ConnectionString Propriété

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

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

public override string ConnectionString { get; set; }

public string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Public Property ConnectionString As String

Valeur de propriété

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

Implémente

Attributs

SettingsBindableAttribute

Remarques

La ConnectionString propriété est conçue pour correspondre au format de chaîne de connexion ODBC aussi étroitement que possible. Il ConnectionString peut être défini uniquement 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 pilote 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"

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)ce qui correspond à la DataSource propriété). Ces propriétés sont mises à jour une fois la connexion ouverte, sauf lorsqu’une erreur est détectée. Dans ce cas, aucune des propriétés n’est mise à jour. OdbcConnection les propriétés (telles que Database) retournent uniquement les paramètres par défaut ou ceux spécifiés dans le ConnectionString.

Une validation de base de la chaîne de connexion se produit dès que vous définissez la ConnectionString propriété. À ce stade, le fournisseur de données vérifie que la chaîne de connexion répond au 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.

Une 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 n’est pas sensible à la casse ; peut être sensible à la casse ; attribute-value et la valeur du mot clé DSN ne se compose pas seulement de vides.

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

Les applications n’ont pas besoin d’ajouter d’accolades autour de la valeur d’attribut après le mot clé Driver, 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 il doit faire partie de la chaîne de connexion retournée.

Valeur de chaîne de connexion ou DSN placée entre 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 retourne une erreur lorsque vous travaillez avec des DSN de fichier, mais passe la 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 de mot clé.

La 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 d’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 à l’aide uniquement des informations de la chaîne de connexion. Le pilote définit les mots clés requis pour se connecter à la source de données.

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

Voir aussi

• Connexion à des sources de données