OracleConnection.ConnectionString Proprietà

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public string ConnectionString { get; set; }

public override string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Property ConnectionString As String

Public Overrides Property ConnectionString As String

Valore della proprietà

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

Implementazioni

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.

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

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.

Si applica a