OracleConnection.ConnectionString Propriété

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

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

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

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

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

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 ("").

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.

Name	Default	Description
source de données - ou - Serveur		Nom ou adresse réseau du instance d’Oracle auquel se connecter.
Sécurité intégrée	'false'	Indique si la connexion doit être sécurisée ou non. Les valeurs reconnues sont true (fortement recommandé), false, yeset no.
Mot de passe		Mot de passe pour la connexion du compte Oracle. Pour maintenir un niveau élevé de sécurité, nous vous recommandons vivement d’utiliser le mot clé de sécurité intégrée à la place.
Persist Security Info	'false'	Lorsqu’elle est définie sur ou no (fortement recommandé), les informations sensibles à false la sécurité telles que le mot de passe ne sont pas retournées dans le cadre de la connexion si la connexion est ouverte ou a déjà été dans un .State La réinitialisation du chaîne de connexion réinitialise toutes les valeurs chaîne de connexion, y compris le mot de passe. Les valeurs reconnues sont true, false, yes et no.
Unicode	'false'	Spécifie si le fournisseur de données .NET Framework pour Oracle utilise des appels d’API en mode UTF16. Cette mot clé est ignorée, sauf lors de l’utilisation du logiciel client Oracle9i.
ID d'utilisateur		Compte de connexion Oracle. Pour maintenir un niveau élevé de sécurité, nous vous recommandons vivement d’utiliser le mot clé de sécurité intégrée à 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 maximale du délai d’attente des connexions mises en pool.
Enlist	'true'	Lorsque true ou yes, le pooleur 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 de la Max Pool Size valeur de peut affecter les ConnectionString performances. Si vous envisagez de créer et d’utiliser activement plus de 100 connexions, vous devez passer Max Pool Size à une valeur qui se rapproche de l’utilisation de la connexion à l’é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’objet OracleConnection 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.

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.