SqlConnection.ConnectionString Propiedad

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public:
 property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

public override string ConnectionString { get; set; }

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

member this.ConnectionString : string with get, set

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Public Property ConnectionString As String

Valor de propiedad

Cadena de conexión que incluye el nombre de la base de datos de origen y otros parámetros necesarios para establecer la conexión inicial. El valor predeterminado es una cadena vacía.

Implementaciones

Atributos

DataSysDescriptionAttribute SettingsBindableAttribute

Excepciones

Ejemplos

En el ejemplo siguiente se crea y SqlConnection se establece la ConnectionString propiedad antes de abrir la conexión.

private static void OpenSqlConnection()
{
    string connectionString = GetConnectionString();

    using (SqlConnection connection = new SqlConnection())
    {
        connection.ConnectionString = connectionString;

        connection.Open();

        Console.WriteLine("State: {0}", connection.State);
        Console.WriteLine("ConnectionString: {0}",
            connection.ConnectionString);
    }
}

static private string GetConnectionString()
{
    // To avoid storing the connection string in your code,
    // you can retrieve it from a configuration file.
    return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
        + "Integrated Security=true;";
}

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Comentarios

ConnectionString es similar a un cadena de conexión OLE DB, pero no es idéntico. A diferencia de OLE DB o ADO, el cadena de conexión que se devuelve es el mismo que el establecido ConnectionStringpor el usuario, menos la información de seguridad si el valor persistir información de seguridad está establecido false en (valor predeterminado). El proveedor de datos de .NET Framework para SQL Server no conserva ni devuelve la contraseña en un cadena de conexión a menos que establezca Persist Security Info trueen .

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.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"

Use el nuevo SqlConnectionStringBuilder para construir cadenas de conexión válidas en tiempo de ejecución. Para obtener más información, vea Generadores de cadenas de conexión.

La ConnectionString propiedad solo se puede establecer cuando se cierra la conexión. Muchos de los valores de cadena de conexión tienen las propiedades de solo lectura correspondientes. Cuando se establece el cadena de conexión, estas propiedades se actualizan, excepto cuando se detecta un error. En este caso, no se actualiza ninguna de las propiedades. SqlConnectionlas propiedades devuelven solo las configuraciones contenidas en .ConnectionString

Para conectarse a un equipo local, especifique "(local)" para el servidor. Si no se especifica un nombre de servidor, se intentará una conexión a la instancia predeterminada en el equipo local.

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. Por ejemplo, si establece un cadena de conexión que incluye "Database= AdventureWorks" y, a continuación, restablece el cadena de conexión en "Data Source=myserver; Integrated Security=true", la Database propiedad ya no está establecida en "AdventureWorks".

El cadena de conexión se analiza inmediatamente después de establecerse. Si se encuentran errores en la sintaxis al analizar, 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 incluye 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 comillas dobles, 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 comillas 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 (por ejemplo, Origen de datos= my'Server o Origen de datos= my"Server), a menos que un carácter de comillas sea el primer o último carácter del valor.

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

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

La lista siguiente contiene los nombres válidos para los valores de agrupación de conexiones dentro de ConnectionString. Para obtener más información, vea Agrupación de conexiones de SQL Server (ADO.NET).

• Duración de la conexión (o tiempo de espera del equilibrio de carga)

• Dar de alta

• Max Pool Size

• Min Pool Size

• Agrupación

Cuando se establecen valores de agrupación de palabra clave o conexión 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

Consulte también

• Proveedores administrados de ADO.NET y centro de desarrolladores de DataSet
• Cadenas de conexión de ADO.NET
• Agrupación de conexiones de SQL Server (ADO.NET)
• Conectarse a un origen de datos en ADO.NET
• Información general de ADO.NET