OracleConnection.ConnectionString Propiedad

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

Valor de propiedad

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

Implementaciones

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.

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

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.

Se aplica a