OracleConnectionStringBuilder.Item[String] Propriété

Définition

Espace de noms:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Obtient ou définit la valeur associée à la clé spécifiée. En C#, cette propriété est l'indexeur.

public:
 virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };

public override object this[string keyword] { get; set; }

member this.Item(string) : obj with get, set

Default Public Overrides Property Item(keyword As String) As Object

Paramètres

keyword

String

Clé de l'élément à obtenir ou définir.

Valeur de propriété

Object

Valeur associée à la clé spécifiée.

Exceptions

ArgumentNullException

keyword est une référence Null (Nothing en Visual Basic).

KeyNotFoundException

A essayé d'ajouter une clé qui ne figure pas parmi les clés disponibles.

FormatException

Valeur non valide dans la chaîne de connexion (plus précisément, une valeur booléenne ou numérique était attendue, mais n'a pas été fournie).

Exemples

Le code suivant, dans une application console, crée un OracleConnectionStringBuilder et ajoute des paires clé/valeur à sa chaîne de connexion, à l'aide de la propriété Item[].

// You may need to set a reference to the System.Data.OracleClient
// assembly before you can run this sample.
using System.Data.OracleClient;

class Program
{
    static void Main()
    {
        OracleConnectionStringBuilder builder =
            new OracleConnectionStringBuilder();
        builder["Data Source"] = "localhost";
        builder["integrated security"] = true;
        builder["Unicode"] = true;

        // Overwrite the existing value for the Data Source value.
        builder["Data Source"] = "NewOracleDemo";

        Console.WriteLine(builder.ConnectionString);
        Console.WriteLine();
        Console.WriteLine("Press Enter to continue.");
        Console.ReadLine();
    }
}

' You may need to set a reference to the System.Data.OracleClient
' assembly before you can run this sample.
Imports System.Data.OracleClient

Module Module1
  Sub Main()
    Dim builder As New OracleConnectionStringBuilder
    builder.Item("Data Source") = "OracleDemo"
    ' Item is the default property, so 
    ' you need not include it in the reference.
    builder("integrated security") = True
    builder.Item("Unicode") = True

    ' Overwrite the existing value for the Data Source value.
    builder.Item("Data Source") = "NewOracleDemo"

    Console.WriteLine(builder.ConnectionString)
    Console.WriteLine()
    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
  End Sub
End Module

Remarques

Dans la mesure où OracleConnectionStringBuilder contient un dictionnaire de taille fixe, la tentative d'ajout d'une clé qui n'existe pas dans le dictionnaire lève une exception KeyNotFoundException. Le tableau suivant répertorie toutes les clés possibles dans le chaîne de connexion, ainsi que la valeur par défaut pour chacune d’elles.

Clé	Propriété	Valeur par défaut
Source de données (ou serveur)	DataSource	Chaîne vide
Conserver les informations de sécurité (ou persistsecurityinfo)	PersistSecurityInfo	Faux
Sécurité intégrée	IntegratedSecurity	Faux
ID utilisateur (ou utilisateur ou uid)	UserID	Chaîne vide
Mot de passe	Password	Chaîne vide
Enlist	Enlist	Vrai
Pooling	Pooling	Vrai
Min Pool Size	MinPoolSize	0
Max Pool Size	MaxPoolSize	100
Omettre le nom de connexion Oracle	OmitOracleConnectionName	Faux
Unicode	Unicode	Faux
Délai d’expiration de l’équilibre de charge (ou durée de vie de la connexion)	LoadBalanceTimeout	0

Voir aussi

• Création de chaînes de connexion