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 comprend des paramètres, tels que le nom de serveur, requis pour établir la connexion initiale. La valeur par défaut est une chaîne vide ("").

Implémente

Attributs

SettingsBindableAttribute

Exemples

L’exemple suivant crée un OracleConnection et définit certaines de ses propriétés dans le chaîne de connexion.

public void CreateOracleConnection()
{
    string connectionString = "Data Source=Oracle8i;Integrated Security=yes";
    using (OracleConnection connection = new OracleConnection(connectionString))
    {
        connection.Open();
        Console.WriteLine("ServerVersion: " + connection.ServerVersion
            + "\nDataSource: " + connection.DataSource);
    }
}

Public Sub CreateOracleConnection()
    Dim connectionString As String = _
       "Data Source=Oracle8i;Integrated Security=yes"

    Using connection As New OracleConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: " + connection.ServerVersion _
           + ControlChars.NewLine + "DataSource: " + connection.DataSource)
    End Using
End Sub

Remarques

Peut ConnectionString être défini uniquement lorsque la connexion est fermée.

Vous pouvez utiliser la ConnectionString propriété pour vous connecter à une base de données. L’exemple suivant illustre une chaîne de connexion classique.

"Data Source=Oracle8i;Integrated Security=yes"  

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=MyServer, qui correspond à la DataSource propriété ). Lorsque le chaîne de connexion est défini, 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. OracleConnectionles propriétés retournent uniquement les paramètres par défaut ou ceux spécifiés dans .ConnectionString

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

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

Le format de base d’un chaîne de connexion est une série de paires mot clé/valeur séparées par des points-virgules. Le signe égal (=) sert de lien entre chaque mot clé et sa valeur. Pour inclure des valeurs qui contiennent un point-virgule, un guillemet simple ou un guillemet double, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un guillemet double, la valeur peut être placée entre guillemets simples. Le guillemet unique est également utile si la valeur commence par un 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 entourer la valeur doit être doublé chaque fois qu’il 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 littéral de chaîne mot clé ou une valeur sont conservés. Des guillemets simples ou doubles peuvent être utilisés dans un chaîne de connexion sans utiliser de délimiteurs, sauf si un guillemet est le premier ou le dernier caractère de la valeur, par exemple ou Data Source= my'ServerData 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 l’hypothétique chaîne de connexion

"key==word=value"  

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

Si une mot clé spécifique dans une paire mot clé/valeur se produit plusieurs fois dans un 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 mot clé ou de connexions 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.

S’applique à