OracleConnectionStringBuilder.Item[String] Proprietà

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Ottiene o imposta il valore associato alla chiave specificata. In C# questa proprietà è l'indicizzatore.

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

Parametri

keyword

String

Chiave dell'elemento da ottenere o impostare.

Valore della proprietà

Object

Valore associato alla chiave specificata.

Eccezioni

ArgumentNullException

keyword è un riferimento null (Nothing in Visual Basic).

KeyNotFoundException

Si è tentato di aggiungere una chiave inesistente tra quelle disponibili.

FormatException

Valore non valido all'interno della stringa di connessione (in maniera specifica, quando il valore booleano o numerico era previsto ma non è stato fornito).

Esempio

Il seguente codice, in un'applicazione della console, crea un nuovo OracleConnectionStringBuilder e aggiunge coppie chiave/valore alla stringa di connessione, con la proprietà 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

Commenti

Poiché l'oggetto OracleConnectionStringBuilder contiene un dizionario di dimensioni fisse, il tentativo di aggiungere una chiave che non esiste nel dizionario genera un'eccezione KeyNotFoundException. Nella tabella seguente sono elencate tutte le chiavi possibili all'interno del stringa di connessione e il valore predefinito per ognuno di essi.

Chiave	Proprietà	Valore predefinito
Origine dati (o server)	DataSource	stringa vuota
Rendere persistenti le informazioni di sicurezza (o persistsecurityinfo)	PersistSecurityInfo	Falso
Sicurezza integrata	IntegratedSecurity	Falso
ID utente (o utente o uid)	UserID	stringa vuota
Password	Password	stringa vuota
Inserisci	Enlist	Vero
Pooling	Pooling	Vero
Dimensione min pool	MinPoolSize	0
Dimensione max pool	MaxPoolSize	100
Omettere il nome della connessione Oracle	OmitOracleConnectionName	Falso
Unicode	Unicode	Falso
Timeout del bilanciamento del carico (o durata della connessione)	LoadBalanceTimeout	0

Vedi anche

• Compilazione delle stringhe di connessione