OracleConnection.ConnectionString Proprietà

Definizione

Spazio dei nomi:

System.Data.OracleClient

Assembly:

System.Data.OracleClient.dll

Ottiene o imposta la stringa utilizzata per aprire un database 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

Valore della proprietà

String

Stringa di connessione Oracle che contiene impostazioni, quali il nome del server, necessarie a stabilire la connessione iniziale. Il valore predefinito è una stringa vuota ("").

Attributi

SettingsBindableAttribute

Esempio

Nell'esempio seguente viene creato un oggetto OracleConnection e vengono impostate alcune delle relative proprietà nel stringa di connessione.

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

Commenti

L'oggetto ConnectionString può essere impostato solo quando la connessione viene chiusa.

È possibile utilizzare la ConnectionString proprietà per connettersi a un database. Nell'esempio seguente viene illustrato un stringa di connessione tipico.

"Data Source=Oracle8i;Integrated Security=yes"  

Molte delle impostazioni specificate nella stringa hanno proprietà di sola lettura corrispondenti , Data Source=MyServerad esempio , che corrisponde alla DataSource proprietà . Quando la stringa di connessione è impostata, tutte queste proprietà vengono aggiornate, a meno che non venga rilevato un errore, nel qual caso nessuna delle proprietà viene aggiornata. OracleConnection le proprietà restituiscono solo le impostazioni predefinite o quelle specificate in ConnectionString.

La reimpostazione di ConnectionString in una connessione chiusa reimposta tutti i valori stringa di connessione (e le proprietà correlate), inclusa la password.

Il stringa di connessione viene analizzato immediatamente dopo l'impostazione. Se l'analisi rivela errori nella sintassi, viene generata un'eccezione di runtime, ad esempio ArgumentException, . È possibile trovare altri errori solo quando viene effettuato un tentativo di apertura della connessione.

Il formato di base di un stringa di connessione è una serie di coppie di parole chiave/valore separate da punto e virgola. Il segno di uguale (=) connette ogni parola chiave al relativo valore. Per includere valori che contengono un punto e virgola, un carattere di virgolette singole o virgolette doppie, il valore deve essere racchiuso tra virgolette doppie. Se il valore contiene sia un punto e virgola che un carattere di virgolette doppie, il valore può essere racchiuso tra virgolette singole. La virgoletta singola è utile anche se il valore inizia con un carattere virgolette doppie. Al contrario, la virgoletta doppia può essere usata se il valore inizia con una virgoletta singola. Se il valore contiene sia virgolette singole che virgolette doppie, il carattere virgolette utilizzato per racchiudere il valore deve essere raddoppiato ogni volta che si verifica all'interno del valore.

Per includere spazi precedenti o finali nel valore stringa, il valore deve essere racchiuso tra virgolette singole o virgolette doppie. Tutti gli spazi iniziali o finali relativi a valori interi, booleani o enumerati vengono ignorati, anche se racchiusi tra virgolette. Tuttavia, gli spazi all'interno di una parola chiave o valore letterale stringa vengono mantenuti. Le virgolette singole o doppie possono essere usate all'interno di un stringa di connessione senza utilizzare delimitatori a meno che un carattere di virgoletta non sia il primo o l'ultimo carattere nel valore, ad esempio o Data Source= my'ServerData Source= my"Server.

Per includere un segno di uguale (=) in una parola chiave o un valore, deve essere preceduto da un altro segno di uguale. Ad esempio, nell'ipotetico stringa di connessione

"key==word=value"  

la parola chiave è "key=word" e il valore è "value".

Se una parola chiave specifica in una coppia di parole chiave/valore si verifica più volte in un stringa di connessione, l'ultima occorrenza viene usata nel set di valori.

Le parole chiave non fanno distinzione tra maiuscole e minuscole.

Nella tabella seguente sono elencati i nomi validi per i valori all'interno di ConnectionString.

Nome	Predefinito	Descrizione
origine dati -oppure- Server		Nome o indirizzo di rete dell'istanza di Oracle a cui connettersi.
Sicurezza integrata	'false'	Specifica se la connessione deve essere protetta. I valori riconosciuti sono true (fortemente consigliati), false, yese no.
Password		Password per l'accesso all'account Oracle. Per mantenere un livello elevato di sicurezza, è consigliabile usare invece la parola chiave Sicurezza integrata.
Persist Security Info	'false'	Se il valore è false su no, informazioni importanti relative alla sicurezza quali, ad esempio, la password, non vengono restituite come parte della connessione se la connessione è aperta o State non si è mai trovata nello stato aperto. La reimpostazione del stringa di connessione reimposta tutti i valori stringa di connessione, inclusa la password. I valori riconosciuti sono true, false, yes e no.
Unicode	'false'	Specifica se il provider di dati .NET Framework per Oracle usa chiamate API in modalità UTF16. Questa parola chiave viene ignorata tranne quando si usa il software client Oracle9i.
ID utente		Account di accesso Oracle. Per mantenere un livello elevato di sicurezza, è consigliabile usare invece la parola chiave Sicurezza integrata.

Nella tabella seguente sono elencati i nomi validi per i valori del pool di connessioni all'interno di ConnectionString.

Nome	Predefinito	Descrizione
Durata della connessione	0	Quando una connessione viene restituita al pool, l'ora di creazione viene confrontata con l'ora corrente e la connessione viene eliminata definitivamente se l'intervallo è superiore al valore in secondi della durata della connessione specificato da Connection Lifetime. Questa è utile nelle configurazioni cluster per applicare il bilanciamento del carico tra un server in esecuzione e un server appena portato online. Il valore zero fa sì che le connessioni in pool abbiano il timeout massimo della connessione.
Inserisci	'true'	Quando true o yes, il pooler inserisce automaticamente la connessione nel contesto di transazione corrente del thread di creazione. I valori riconosciuti sono true, false, yes e no.
Dimensione max pool	100	Numero massimo di connessioni consentite nel pool. L'impostazione del Max Pool Size valore di ConnectionString può influire sulle prestazioni. Se si prevede di creare e usare attivamente più di 100 connessioni, è consigliabile aumentare Max Pool Size a un valore che approssima l'utilizzo della connessione a stato stabile per l'applicazione.
Dimensione min pool	0	Numero minimo di connessioni consentite nel pool.
Pooling	'true'	Quando true o yes, l'oggetto OracleConnection viene disegnato dal pool appropriato o, se necessario, viene creato e aggiunto al pool appropriato. I valori riconosciuti sono true, false, yes e no.

Quando si impostano valori di pool di parole chiave o di connessione che richiedono un valore booleano, è possibile usare "sì" anziché "true" e "no" anziché "false". I valori integer sono rappresentati come stringhe.