OracleConnection.ConnectionString Propiedad

Definición

Espacio de nombres:

System.Data.OracleClient

Ensamblado:

System.Data.OracleClient.dll

Obtiene o establece la cadena que se utiliza para abrir una base de datos de 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

Valor de propiedad

String

Cadena de conexión de Oracle que incluye valores, como el nombre del servidor, necesarios para establecer la conexión inicial. El valor predeterminado es una cadena vacía ("").

Atributos

SettingsBindableAttribute

Ejemplos

En el ejemplo siguiente se crea y OracleConnection se establecen algunas de sus propiedades en el cadena de conexión.

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

Comentarios

ConnectionString Solo se puede establecer cuando se cierra la conexión.

Puede usar la ConnectionString propiedad para conectarse a una base de datos. En el ejemplo siguiente se muestra un cadena de conexión típico.

"Data Source=Oracle8i;Integrated Security=yes"  

Muchos de los valores especificados en la cadena tienen las propiedades de solo lectura correspondientes (por ejemplo, Data Source=MyServer, que corresponde a la DataSource propiedad ). Cuando se establece el cadena de conexión, se actualizan todas estas propiedades, a menos que se detecte un error, en cuyo caso no se actualiza ninguna de las propiedades. OracleConnectionlas propiedades devuelven solo la configuración predeterminada o la especificada en .ConnectionString

Al restablecer en ConnectionString una conexión cerrada, se restablecen todos los valores de cadena de conexión (y las propiedades relacionadas), incluida la contraseña.

El cadena de conexión se analiza inmediatamente después de establecerse. Si el análisis revela errores en la sintaxis, se genera una excepción en tiempo de ejecución, como ArgumentException, . Solo se pueden encontrar otros errores cuando se intenta abrir la conexión.

El formato básico de un cadena de conexión es una serie de pares de palabra clave-valor separados por punto y coma. El signo igual (=) asocia cada palabra clave a su valor. Para incluir valores que contienen un punto y coma, un carácter de comillas simples o un carácter de comillas dobles, el valor debe ir entre comillas dobles. Si el valor contiene un punto y coma y un carácter de comilla doble, el valor se puede incluir entre comillas simples. La comilla simple también es útil si el valor comienza con un carácter de comilla doble. Por el contrario, se puede usar la comilla doble si el valor comienza con una comilla simple. Si el valor contiene caracteres de comillas simples y comillas dobles, el carácter de comilla usado para incluir el valor se debe duplicar cada vez que se produce dentro del valor.

Para incluir espacios anteriores o finales en el valor de cadena, el valor debe ir entre comillas simples o comillas dobles. Se omiten los espacios iniciales o finales alrededor de valores enteros, booleanos o enumerados, incluso si se incluyen entre comillas. Sin embargo, se conservan los espacios dentro de una palabra clave o valor literal de cadena. Las comillas simples o dobles se pueden usar dentro de un cadena de conexión sin usar delimitadores a menos que un carácter de comillas sea el primer o último carácter del valor, por ejemplo, Data Source= my'Server o Data Source= my"Server.

Para incluir un signo igual (=) en una palabra clave o un valor, debe ir precedido por otro signo igual. Por ejemplo, en la hipotética cadena de conexión

"key==word=value"  

la palabra clave es "key=word" y el valor es "value".

Si una palabra clave específica de un par palabra clave-valor se produce más de una vez en un cadena de conexión, la última aparición se usa en el conjunto de valores.

Las palabras clave no distinguen mayúsculas de minúsculas.

En la tabla siguiente se enumeran los nombres válidos para los valores de ConnectionString.

Nombre	Valor predeterminado	Descripción
Origen de datos o bien Servidor		Nombre o dirección de red de la instancia de Oracle a la que se va a conectar.
Seguridad integrada	'false'	Si la conexión será una conexión segura o no. Los valores reconocidos son true (muy recomendados), false, yesy no.
Contraseña		Contraseña para el inicio de sesión de la cuenta de Oracle. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar la palabra clave Seguridad integrada en su lugar.
Persist Security Info	'false'	Cuando se establece false en o no (se recomienda encarecidamente), la información confidencial de seguridad, como la contraseña, no se devuelve como parte de la conexión si la conexión está abierta o alguna vez está abierta State. Al restablecer el cadena de conexión se restablecen todos los valores de cadena de conexión, incluida la contraseña. Los valores reconocidos son true, false, yes y no.
Unicode	'false'	Especifica si el proveedor de datos de .NET Framework para Oracle usa llamadas API de modo UTF16. Esta palabra clave se omite, excepto cuando se usa el software cliente oracle9i.
Id. de usuario		La cuenta de inicio de sesión de Oracle. Para mantener un alto nivel de seguridad, se recomienda encarecidamente usar la palabra clave Seguridad integrada en su lugar.

En la tabla siguiente se enumeran los nombres válidos para los valores de agrupación de conexiones dentro de ConnectionString.

Nombre	Valor predeterminado	Descripción
Duración de la conexión	0	Cuando una conexión se devuelve al grupo, su hora de creación se compara con la hora actual y, si ese marco temporal (en segundos) supera el valor especificado por Connection Lifetime, la conexión se destruye. Esto resulta de utilidad en configuraciones agrupadas para forzar el equilibrio de carga entre un servidor en ejecución y uno que acaba de conectarse. Un valor de cero hace que las conexiones agrupadas tengan el tiempo de espera máximo de conexión.
Dar de alta	'true'	Cuando true o yes, el agrupador da de alta automáticamente la conexión en el contexto de transacción actual del subproceso de creación. Los valores reconocidos son true, false, yes y no.
Max Pool Size	100	El número máximo de conexiones permitido en el grupo. Establecer el Max Pool Size valor de ConnectionString puede afectar al rendimiento. Si tiene previsto crear y usar activamente más de 100 conexiones, debe aumentar Max Pool Size a un valor que aproxima el uso de la conexión de estado estable para la aplicación.
Min Pool Size	0	Número mínimo de conexiones permitidas en el grupo.
Agrupación	'true'	Cuando true o yes, el OracleConnection objeto se dibuja del grupo adecuado, o si es necesario, se crea y se agrega al grupo adecuado. Los valores reconocidos son true, false, yes y no.

Al establecer la palabra clave o los valores de agrupación de conexiones que requieren un valor booleano, puede usar "sí" en lugar de "true" y "no" en lugar de "false". Los valores enteros se representan como cadenas.