OracleConnectionStringBuilder.Item[String] Propriété

  • Référence

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

S’applique à

Voir aussi