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 include impostazioni, ad esempio il nome del server, necessarie per stabilire la connessione iniziale. Il valore predefinito è una stringa vuota ("").

Implementazioni

Attributi

SettingsBindableAttribute

Commenti

ConnectionString Può essere impostato solo quando la connessione viene chiusa.

È possibile utilizzare la ConnectionString proprietà per connettersi a un database.

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 della stringa di connessione (e le proprietà correlate), inclusa la password.

La stringa di connessione viene analizzata 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 aprire la connessione.

Il formato di base di una stringa di connessione è una serie di coppie di parole chiave/valore separate da punti e virgola. Il segno di uguale (=) connette ogni parola chiave e il relativo valore. Per includere valori che contengono un punto e virgola, un carattere 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 virgolette doppie, il valore può essere racchiuso tra virgolette singole. La virgoletta singola è utile anche se il valore inizia con un carattere virgolette doppie. Viceversa, 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 intorno 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 una stringa di connessione senza utilizzare delimitatori, a meno che un carattere di virgoletta non sia il primo o l'ultimo carattere nel valore, Data Source= my'Server ad esempio o Data 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, nella stringa di connessione ipotetica

"key==word=value"

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

Se una parola chiave specifica in una coppia parola chiave/valore si verifica più di una volta in una 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.