OracleConnection.ConnectionString Propriété

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

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

public string ConnectionString { get; set; }

public override 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 Property ConnectionString As String

Public Overrides Property ConnectionString As String

Valeur de propriété

Chaîne de connexion Oracle qui inclut des paramètres, tels que le nom du serveur, nécessaires pour établir la connexion initiale. La valeur par défaut est une chaîne vide ("").

Implémente

Attributs

SettingsBindableAttribute

Remarques

Il ConnectionString ne peut être défini que lorsque la connexion est fermée.

Vous pouvez utiliser la ConnectionString propriété pour vous connecter à une base de données.

La plupart des paramètres spécifiés dans la chaîne ont des propriétés en lecture seule correspondantes (par exemple, Data Source=MyServerce qui correspond à la DataSource propriété). Lorsque la chaîne de connexion est définie, toutes ces propriétés sont mises à jour, sauf si une erreur est détectée, auquel cas aucune des propriétés n’est mise à jour. OracleConnection les propriétés retournent uniquement les paramètres par défaut ou ceux spécifiés dans le ConnectionString.

La réinitialisation de la ConnectionString connexion fermée réinitialise toutes les valeurs de chaîne de connexion (et les propriétés associées), y compris le mot de passe.

La chaîne de connexion est analysée immédiatement après avoir été définie. Si l’analyse révèle des erreurs dans la syntaxe, une exception au moment de l’exécution, telle que ArgumentException, est générée. D’autres erreurs peuvent être trouvées uniquement lorsqu’une tentative d’ouverture de la connexion est effectuée.

Le format de base d’une chaîne de connexion est une série de paires mot clé/valeur séparées par des points-virgules. Le signe égal (=) connecte chaque mot clé et sa valeur. Pour inclure des valeurs qui contiennent un point-virgule, un caractère de guillemet unique ou un caractère de guillemets doubles, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un caractère de guillemets doubles, la valeur peut être placée entre guillemets simples. Le guillemet unique est également utile si la valeur commence par un caractère de guillemet double. À l’inverse, le guillemet double peut être utilisé si la valeur commence par un guillemet unique. Si la valeur contient à la fois des guillemets simples et des guillemets doubles, le caractère de guillemet utilisé pour placer la valeur doit être doublé chaque fois qu’elle se produit dans la valeur.

Pour inclure des espaces précédents ou de fin dans la valeur de chaîne, la valeur doit être placée entre guillemets simples ou guillemets doubles. Tous les espaces de début ou de fin autour des valeurs entières, booléennes ou énumérées sont ignorés, même s’ils sont placés entre guillemets. Toutefois, les espaces dans un mot clé littéral de chaîne ou une valeur sont conservés. Les guillemets simples ou doubles peuvent être utilisés dans une chaîne de connexion sans utiliser de délimiteurs, sauf si un caractère de guillemet est le premier ou le dernier caractère de la valeur, par exemple, Data Source= my'Server ou Data Source= my"Server.

Pour inclure un signe égal (=) dans un mot clé ou une valeur, il doit être précédé d’un autre signe égal. Par exemple, dans la chaîne de connexion hypothétique

"key==word=value"

le mot clé est « key=word » et la valeur est « value ».

Si un mot clé spécifique dans une paire mot clé/valeur se produit plusieurs fois dans une chaîne de connexion, la dernière occurrence est utilisée dans le jeu de valeurs.

Les mots clés ne respectent pas la casse.

Le tableau suivant répertorie les noms valides pour les valeurs dans le ConnectionString.

Le tableau suivant répertorie les noms valides pour les valeurs de regroupement de connexions dans le ConnectionString.

Lorsque vous définissez des valeurs de regroupement de mots clés ou de connexion qui nécessitent une valeur booléenne, vous pouvez utiliser « oui » au lieu de « true » et « non » au lieu de « false ». Les valeurs entières sont représentées sous forme de chaînes.