OracleConnection.ConnectionString OracleConnection.ConnectionString OracleConnection.ConnectionString OracleConnection.ConnectionString Property

Definizione

Ottiene o imposta la stringa utilizzata per aprire un database Oracle.Gets or sets the string used to open an Oracle database.

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };
[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }
member this.ConnectionString : string with get, set
Public Overrides Property ConnectionString As String

Valore della proprietà

La stringa di connessione Oracle che contiene impostazioni, ad esempio il nome del server, è necessaria per stabilire la connessione iniziale.The Oracle connection string that includes settings, such as the server name, needed to establish the initial connection. Il valore predefinito è una stringa vuota ("").The default value is an empty string ("").

Esempi

L'esempio seguente crea un OracleConnection e alcune proprietà vengono impostate nella stringa di connessione.The following example creates an OracleConnection and sets some of its properties in the connection string.

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

Il ConnectionString può essere impostata solo quando la connessione viene chiusa.The ConnectionString can be set only when the connection is closed.

È possibile usare il ConnectionString proprietà per la connessione a un database.You can use the ConnectionString property to connect to a database. Nell'esempio seguente viene illustrata una stringa di connessione tipica.The following example illustrates a typical connection string.

"Data Source=Oracle8i;Integrated Security=yes"  

Molte delle impostazioni specificate nella stringa hanno corrispondente proprietà di sola lettura (ad esempio, Data Source=MyServer, che corrisponde alla DataSource proprietà).Many of the settings specified in the string have corresponding read-only properties (for example, Data Source=MyServer, which corresponds to the DataSource property). Quando la stringa di connessione è impostata, tutte queste proprietà vengono aggiornate, a meno che non viene rilevato un errore, nel qual caso nessuna delle proprietà vengono aggiornata.When the connection string is set, all of these properties are updated, unless an error is detected, in which case none of the properties are updated. OracleConnection le proprietà restituiscono solo le impostazioni predefinite o le impostazioni specificate nel ConnectionString.OracleConnection properties return only default settings or those settings specified in the ConnectionString.

La reimpostazione di ConnectionString in una connessione chiusa Reimposta tutte le connessione stringa valori e le proprietà correlate, inclusa la password.Resetting the ConnectionString on a closed connection resets all connection string values (and related properties), including the password.

La stringa di connessione viene analizzata immediatamente dopo l'impostazione.The connection string is parsed immediately after being set. Se l'analisi vengono rilevati errori nella sintassi, un'eccezione in fase di esecuzione, ad esempio ArgumentException, viene generato.If parsing reveals errors in syntax, a run-time exception, such as ArgumentException, is generated. Altri errori si trovano solo quando viene effettuato un tentativo di aprire la connessione.Other errors can be found only when an attempt is made to open the connection.

Il formato di base di una stringa di connessione è una serie di coppie parola chiave/valore separate da punti e virgola.The basic format of a connection string is a series of keyword/value pairs separated by semicolons. Il segno di uguale (=) connette ogni parola chiave al relativo valore.The equal sign (=) connects each keyword and its value. Per includere i valori che contengono un punto e virgola, virgoletta singola o virgolette doppie, il valore deve essere racchiuso tra virgolette doppie.To include values that contain a semicolon, single-quote character, or double-quote character, the value must be enclosed in double quotes. Se il valore contiene un punto e virgola sia un carattere di virgolette doppie, il valore può essere racchiuso tra virgolette singole.If the value contains both a semicolon and a double-quote character, the value can be enclosed in single quotes. La virgoletta singola è utile anche se il valore inizia con un carattere di virgolette doppie.The single quote is also useful if the value begins with a double-quote character. Viceversa, le virgolette doppie possono essere utilizzate se il valore inizia con una virgoletta singola.Conversely, the double quote can be used if the value begins with a single quote. Se il valore contiene caratteri di virgoletta singola e virgolette doppie, il carattere virgoletta usato per delimitare il valore deve essere raddoppiato ogni volta che si verifica all'interno del valore.If the value contains both single-quote and double-quote characters, the quote character used to enclose the value must be doubled each time it occurs within the value.

Per includere il valore della stringa spazi iniziali o finali, il valore deve essere racchiuso tra virgolette singole o virgolette doppie.To include preceding or trailing spaces in the string value, the value must be enclosed in either single quotes or double quotes. Eventuali spazi iniziali o finali integer, Boolean o valori enumerati sono ignorati, anche se racchiusi tra virgolette.Any leading or trailing spaces around integer, Boolean, or enumerated values are ignored, even if enclosed in quotes. Tuttavia, vengono mantenuti gli spazi all'interno di una parola chiave della stringa letterale o un valore.However, spaces within a string literal keyword or value are preserved. Le virgolette singole o doppie possono essere usate all'interno di una stringa di connessione senza delimitatori, a meno che un carattere di virgolette è il primo o ultimo carattere nel valore, ad esempio Data Source= my'Server o Data Source= my"Server.Single or double quotes may be used within a connection string without using delimiters unless a quote character is the first or last character in the value, for example, Data Source= my'Server or 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.To include an equal sign (=) in a keyword or value, it must be preceded by another equal sign. Ad esempio, nella stringa di connessione ipoteticaFor example, in the hypothetical connection string

"key==word=value"  

la parola chiave è "chiave = word" e il valore è "value".the keyword is "key=word" and the value is "value".

Se una parola chiave specifica in una coppia parola chiave/valore si verifica più volte in una stringa di connessione, viene utilizzato l'ultima occorrenza del set di valore.If a specific keyword in a keyword/value pair occurs more than once in a connection string, the last occurrence is used in the value set.

Le parole chiave sono maiuscole e minuscole.Keywords are case insensitive.

La tabella seguente elenca i nomi validi per i valori all'interno di ConnectionString.The following table lists the valid names for values within the ConnectionString.

NomeName Impostazione predefinitaDefault DescrizioneDescription
origine datiData Source

-oppure--or-

ServerServer
Il nome o indirizzo di rete dell'istanza di Oracle a cui connettersi.The name or network address of the instance of Oracle to which to connect.
Sicurezza integrataIntegrated Security 'false''false' Se la connessione deve essere una connessione sicura o non.Whether the connection is to be a secure connection or not.

I valori riconosciuti sono true (scelta consigliata), false, yes, e no.Recognized values are true (strongly recommended), false, yes, and no.
PasswordPassword La password per l'accesso all'account di Oracle.The password for the Oracle account logging on. Per mantenere un elevato livello di sicurezza, è consigliabile usare invece la parola chiave di sicurezza integrata.To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.
Persist Security InfoPersist Security Info 'false''false' Se impostato su false oppure no (scelta consigliata), informazioni riservate, ad esempio la password non viene restituite come parte della connessione se la connessione è aperta o è già stata un'apertura State.When set to false or no (strongly recommended), security-sensitive information such as the password is not returned as part of the connection if the connection is open or has ever been in an open State. Reimpostare la stringa di connessione Reimposta tutti i valori di stringa di connessione, inclusa la password.Resetting the connection string resets all connection string values, including the password.

I valori riconosciuti sono true, false, yes e no.Recognized values are true, false, yes, and no.
UnicodeUnicode 'false''false' Specifica se il Provider di dati .NET Framework per Oracle Usa chiamate ad API modalità UTF16.Specifies whether the .NET Framework Data Provider for Oracle uses UTF16 mode API calls. Questa parola chiave viene ignorata, tranne quando si utilizza il software client di Oracle9i.This keyword is ignored except when using Oracle9i client software.
ID utenteUser ID L'account di accesso di Oracle.The Oracle login account. Per mantenere un elevato livello di sicurezza, è consigliabile usare invece la parola chiave di sicurezza integrata.To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.

La tabella seguente elenca i nomi validi per i valori all'interno del pool di ConnectionString.The following table lists the valid names for connection pooling values within the ConnectionString.

NomeName Impostazione predefinitaDefault DescrizioneDescription
Durata connessioneConnection Lifetime 00 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.When a connection is returned to the pool, its creation time is compared with the current time, and the connection is destroyed if that time span (in seconds) exceeds the value specified by Connection Lifetime. Questa è utile nelle configurazioni cluster per applicare il bilanciamento del carico tra un server in esecuzione e un server appena portato online.This is useful in clustered configurations to force load balancing between a running server and a server just brought online.

Un valore pari a zero, connessioni in pool i timeout di connessione massimo.A value of zero causes pooled connections to have the maximum connection time-out.
InserisciEnlist 'true''true' Quando true o yes, inserisce automaticamente la connessione nel contesto della transazione corrente del thread di creazione.When true or yes, the pooler automatically enlists the connection in the creation thread's current transaction context.

I valori riconosciuti sono true, false, yes e no.Recognized values are true, false, yes, and no.
Dimensione max poolMax Pool Size 100100 Numero massimo di connessioni consentite nel pool.The maximum number of connections allowed in the pool. Impostando il Max Pool Size pari al ConnectionString può influire sulle prestazioni.Setting the Max Pool Size value of the ConnectionString can affect performance. Se si prevede di creare e attivamente utilizza più di 100 connessioni, è necessario aumentare Max Pool Size su un valore che rappresenta un'approssimazione all'utilizzo delle connessioni nello stato stazionario per l'applicazione.If you plan to create and actively use more than 100 connections, you should increase Max Pool Size to a value that approximates the steady-state connection usage for the application.
Dimensione min poolMin Pool Size 00 Il numero minimo di connessioni consentite nel pool.The minimum number of connections allowed in the pool.
PoolingPooling 'true''true' Quando true oppure yes, il OracleConnection oggetto viene disegnato dal pool appropriato o, se necessario, viene creato e aggiunto al pool appropriato.When true or yes, the OracleConnection object is drawn from the appropriate pool, or if necessary, is created and added to the appropriate pool.

I valori riconosciuti sono true, false, yes e no.Recognized values are true, false, yes, and no.

Quando si impostano i valori che richiedono un valore booleano di pool di connessioni o parola chiave, è possibile usare 'Sì' anziché 'true' e 'no' anziché 'false'.When setting keyword or connection pooling values that require a Boolean value, you can use 'yes' instead of 'true', and 'no' instead of 'false'. I valori integer sono rappresentati come stringhe.Integer values are represented as strings.

Si applica a