OracleConnectionStringBuilder.Item[String] Proprietà

  • Riferimento

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

Si applica a

Vedi anche