SqlConnection.Open Método

Definición

Espacio de nombres:

Microsoft.Data.SqlClient

Ensamblado:

Microsoft.Data.SqlClient.dll

Paquete:

Microsoft.Data.SqlClient v5.2.0

Sobrecargas

Open()	Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.
Open(SqlConnectionOverrides)	Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.

Open()

Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.

public:
 override void Open();

public override void Open ();

override this.Open : unit -> unit

Public Overrides Sub Open ()

Excepciones

InvalidOperationException

No se puede abrir una conexión sin especificar un servidor u origen de datos.

o

La conexión ya está abierta.

SqlException

Se produjo un error de nivel de conexión mientras se abría la conexión. Si la propiedad Number contiene el valor 18487 o 18488, indica que la contraseña especificada expiró o debe restablecerse. Vea el método ChangePassword(String, String) para más información.

La etiqueta <system.data.localdb> en el archivo app.config tiene elementos no válidos o desconocidos.

ConfigurationErrorsException

Hay dos entradas con el mismo nombre en la sección <localdbinstances>.

Ejemplos

En el ejemplo siguiente se crea , SqlConnectionse abre y se muestran algunas de sus propiedades. La conexión se cierra automáticamente al final del using bloque.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    private static void OpenSqlConnection(string connectionString)
    {
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
            Console.WriteLine("State: {0}", connection.State);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Comentarios

SqlConnection dibuja una conexión abierta del grupo de conexiones si hay una disponible. De lo contrario, establece una nueva conexión a una instancia de SQL Server.

Nota:

SqlConnection Si sale del ámbito, no se cierra. Por lo tanto, debe cerrar explícitamente la conexión mediante una llamada a Close.

Nota:

Si especifica un número de puerto distinto de 1433 cuando intenta conectarse a una instancia de SQL Server y usa un protocolo distinto de TCP/IP, se produce un error en el Open método. Para especificar un número de puerto distinto de 1433, incluya "server=machinename,port number" en la cadena de conexión y use el protocolo TCP/IP.

Nota:

El proveedor de datos de .NET Framework para SQL Server requiere el permiso Seguridad con "Permite llamadas a ensamblados no administrados" habilitado (SecurityPermission con establecido en UnmanagedCode) para abrir un SqlConnection con la depuración SecurityPermissionFlag de SQL habilitada.

Open(SqlConnectionOverrides)

Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.

public:
 void Open(Microsoft::Data::SqlClient::SqlConnectionOverrides overrides);

public void Open (Microsoft.Data.SqlClient.SqlConnectionOverrides overrides);

override this.Open : Microsoft.Data.SqlClient.SqlConnectionOverrides -> unit

Public Sub Open (overrides As SqlConnectionOverrides)

Parámetros

overrides

SqlConnectionOverrides

Opciones para invalidar el comportamiento predeterminado de apertura de la conexión.

Excepciones

InvalidOperationException

No se puede abrir una conexión sin especificar un servidor u origen de datos.

o

La conexión ya está abierta.

SqlException

Se produjo un error de nivel de conexión mientras se abría la conexión. Si la propiedad Number contiene el valor 18487 o 18488, indica que la contraseña especificada expiró o debe restablecerse. Vea el método ChangePassword(String, String) para más información.

La etiqueta <system.data.localdb> en el archivo app.config tiene elementos no válidos o desconocidos.

ConfigurationErrorsException

Hay dos entradas con el mismo nombre en la sección <localdbinstances>.

Ejemplos

En el ejemplo siguiente se crea , SqlConnectionse abre y se muestran algunas de sus propiedades. La conexión se cierra automáticamente al final del using bloque.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

    private static void OpenSqlConnection(string connectionString)
    {
        using (SqlConnection connection = new SqlConnection(connectionString))
        {
            connection.Open();
            Console.WriteLine("ServerVersion: {0}", connection.ServerVersion);
            Console.WriteLine("State: {0}", connection.State);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Comentarios

SqlConnection dibuja una conexión abierta del grupo de conexiones si hay una disponible. De lo contrario, establece una nueva conexión a una instancia de SQL Server. Si se especifican invalidaciones, el primer intento de apertura aplicará las invalidaciones especificadas a la acción de apertura.

Nota:

SqlConnection Si sale del ámbito, no se cierra. Por lo tanto, debe cerrar explícitamente la conexión mediante una llamada a Close.

Nota:

Si especifica un número de puerto distinto de 1433 cuando intenta conectarse a una instancia de SQL Server y usa un protocolo distinto de TCP/IP, se produce un error en el Open método. Para especificar un número de puerto distinto de 1433, incluya "server=machinename,port number" en la cadena de conexión y use el protocolo TCP/IP.

Nota:

El proveedor de datos de .NET Framework para SQL Server requiere el permiso Seguridad con "Permite llamadas a ensamblados no administrados" habilitado (SecurityPermission con establecido en UnmanagedCode) para abrir un SqlConnection con la depuración SecurityPermissionFlag de SQL habilitada.