OracleConnection.ConnectionString Proprietà

Definizione

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

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
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.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 ("").

Implementazioni

Attributi

Esempi

Nell'esempio seguente viene creata una OracleConnection e vengono impostate alcune proprietà 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 impostato solo quando la connessione viene chiusa.The ConnectionString can be set only when the connection is closed.

È possibile utilizzare la proprietà ConnectionString per connettersi 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 proprietà di sola lettura corrispondenti, ad esempio Data Source=MyServer, che corrisponde alla proprietà DataSource.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 viene impostata la stringa di connessione, tutte queste proprietà vengono aggiornate, a meno che non venga rilevato un errore, nel qual caso nessuna delle proprietà viene 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 proprietà restituiscono solo le impostazioni predefinite o quelle specificate nella ConnectionString.OracleConnection properties return only default settings or those settings specified in the ConnectionString.

Reimpostando il ConnectionString in una connessione chiusa vengono reimpostati tutti i valori della stringa di connessione (e le relative proprietà), 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 rivela errori nella sintassi, viene generata un'eccezione in fase di esecuzione, ad esempio ArgumentException.If parsing reveals errors in syntax, a run-time exception, such as ArgumentException, is generated. È possibile trovare altri errori solo quando viene effettuato un tentativo di apertura della 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 è costituito da 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 valori che contengono un punto e virgola, un carattere virgolette singole 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 e un carattere 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, è possibile utilizzare le virgolette doppie 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 virgolette singole e virgolette doppie, il carattere virgolette utilizzato per racchiudere 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 gli spazi iniziali o finali nel valore stringa, 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. Tutti gli spazi iniziali o finali intorno ai valori integer, booleani o enumerati vengono 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 conservati gli spazi all'interno di una parola chiave o valore letterale stringa.However, spaces within a string literal keyword or value are preserved. È possibile utilizzare le virgolette singole o doppie all'interno di una stringa di connessione senza utilizzare delimitatori, a meno che un carattere virgolette non sia il primo o l'ultimo carattere del 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 in 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 è "Key = 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ù di una volta in una stringa di connessione, viene utilizzata l'ultima occorrenza nel set di valori.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.

Parole chiave senza distinzione tra maiuscole e minuscole.Keywords are case insensitive.

Nella tabella seguente sono elencati i nomi validi per i valori all'interno del ConnectionString.The following table lists the valid names for values within the ConnectionString.

NameName DefaultDefault DescrizioneDescription
Origine datiData Source

-oppure--or-

ServerServer
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' Specifica se la connessione deve essere protetta.Whether the connection is to be a secure connection or not.

I valori riconosciuti sono true (fortemente consigliato), false, yese no.Recognized values are true (strongly recommended), false, yes, and no.
PasswordPassword Password per l'accesso all'account Oracle.The password for the Oracle account logging on. Per mantenere un livello elevato di protezione, è consigliabile usare invece la parola chiave Integrated Security.To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.
Mantieni informazioni di sicurezzaPersist Security Info false'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.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. La reimpostazione della stringa di connessione reimposta tutti i valori della 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 .NET Framework provider di dati per Oracle USA chiamate API in modalità UTF16.Specifies whether the .NET Framework Data Provider for Oracle uses UTF16 mode API calls. Questa parola chiave viene ignorata tranne quando si usa il software client di Oracle9i.This keyword is ignored except when using Oracle9i client software.
ID utenteUser ID Account di accesso Oracle.The Oracle login account. Per mantenere un livello elevato di protezione, è consigliabile usare invece la parola chiave Integrated Security.To maintain a high level of security, we strongly recommend that you use the Integrated Security keyword instead.

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

NameName DefaultDefault 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 causa il timeout massimo della connessione per le connessioni in pool.A value of zero causes pooled connections to have the maximum connection time-out.
EnlistEnlist 'true''true' Quando true o yes, pool integra automaticamente la connessione nel contesto di 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.
Dimensioni massime poolMax Pool Size 100100 Numero massimo di connessioni consentite nel pool.The maximum number of connections allowed in the pool. L'impostazione del valore Max Pool Size della ConnectionString può influire sulle prestazioni.Setting the Max Pool Size value of the ConnectionString can affect performance. Se si prevede di creare e utilizzare attivamente più di 100 connessioni, è necessario aumentare Max Pool Size a un valore che apparirà l'utilizzo della connessione di 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 minima poolMin Pool Size 00 Numero minimo di connessioni consentite nel pool.The minimum number of connections allowed in the pool.
PoolingPooling 'true''true' Quando true o yes, l'oggetto OracleConnection 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 valori di parole chiave o pool di connessioni che richiedono un valore booleano, è possibile usare ' Yes ' anziché' true ' è No ' invece di ' 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