OracleConnection.ConnectionString Propriété

Définition

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

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é

String

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

Exemples

L’exemple suivant crée un OracleConnection et définit certaines de ses propriétés dans la 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

Le ConnectionString peut ê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 la chaîne de connexion est définie, toutes ces propriétés sont mises à jour, à moins qu’une erreur ne soit 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 les paramètres spécifiés dans le ConnectionString .

La réinitialisation ConnectionString de sur une 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 ne peuvent être trouvées qu’en cas de tentative d’ouverture de la connexion.

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 (=) sert de lien entre chaque mot clé et sa valeur. Pour inclure des valeurs qui contiennent un point-virgule, un caractère apostrophe ou un guillemet double, la valeur doit être placée entre guillemets doubles. Si la valeur contient à la fois un point-virgule et un caractère guillemet double, la valeur peut être placée entre guillemets simples. Le guillemet simple 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 simple. Si la valeur contient à la fois des guillemets simples et des guillemets doubles, le caractère de guillemets utilisé pour encadrer la valeur doit être doublé chaque fois qu’elle se produit dans la valeur.

Pour inclure des espaces de début ou de fin dans la valeur de chaîne, la valeur doit être placée entre guillemets simples ou guillemets doubles. 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 au sein d’un mot clé ou d’une valeur de littéral de chaîne 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 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 apparaît plusieurs fois dans une chaîne de connexion, la dernière occurrence est utilisée dans la valeur définie.

Les mots clés ne respectent pas la casse.

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

Name Default Description
source de données

- ou -

Serveur
Nom ou adresse réseau de l’instance d’Oracle à laquelle se connecter.
Sécurité intégrée fausses Indique si la connexion doit être sécurisée ou non.

Les valeurs reconnues sont true (fortement recommandées),, false yes et no .
Mot de passe Mot de passe du compte Oracle qui ouvre une session. Pour garantir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser le mot clé Integrated Security à la place.
Persist Security Info fausses Quand la valeur false no est ou (vivement recommandée), les informations sensibles sur la sécurité, telles que le mot de passe, ne sont pas renvoyées dans le cadre de la connexion si la connexion est ouverte ou si elle a déjà été ouverte State . La réinitialisation de la chaîne de connexion réinitialise toutes les valeurs de chaîne de connexion, y compris le mot de passe.

Les valeurs reconnues sont true, false, yes et no.
Unicode fausses spécifie si le Fournisseur de données .NET Framework pour Oracle utilise des appels d’API en mode UTF16. Ce mot clé est ignoré, sauf lors de l’utilisation du logiciel client Oracle9i.
ID d'utilisateur Compte de connexion Oracle. Pour garantir un niveau de sécurité élevé, nous vous recommandons vivement d’utiliser le mot clé Integrated Security à la place.

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

Name Default Description
Durée de vie de la connexion 0 Lorsqu’une connexion est retournée au pool, l’heure de sa création est comparée à l’heure actuelle et la connexion est détruite si cet intervalle de temps (en secondes) excède la valeur spécifiée par Connection Lifetime. Cela est utile dans les configurations en clusters pour forcer l'équilibrage de la charge entre un serveur en cours d'exécution et un serveur qui vient d'être mis en ligne.

La valeur zéro entraîne l’expiration du délai de connexion maximal pour les connexions regroupées.
Enlist 'true' Lorsque true ou yes , le Pooler inscrit automatiquement la connexion dans le contexte de transaction actuel du thread de création.

Les valeurs reconnues sont true, false, yes et no.
Max Pool Size 100 Nombre maximal de connexions autorisées dans le pool. La définition Max Pool Size de la valeur de ConnectionString peut affecter les performances. Si vous envisagez de créer et d’utiliser activement plus de 100 connexions, vous devez augmenter Max Pool Size jusqu’à une valeur qui correspond approximativement à l’utilisation de la connexion en état stable pour l’application.
Min Pool Size 0 Nombre minimal de connexions autorisées dans le pool.
Pooling 'true' Lorsque true ou yes , l' OracleConnection objet est dessiné à partir du pool approprié ou, si nécessaire, est créé et ajouté au pool approprié.

Les valeurs reconnues sont true, false, yes et no.

Lors de la définition de valeurs de mot clé ou de regroupement de connexions qui requièrent une valeur booléenne, vous pouvez utiliser « Yes » au lieu de « true », et « no » au lieu de « false ». Les valeurs entières sont représentées sous forme de chaînes.

S’applique à