SqlConnection.Open Método

Definición

Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.Opens a database connection with the property settings specified by the ConnectionString.

public:
 virtual void Open();
public void Open ();
abstract member Open : unit -> unit
override this.Open : unit -> unit
Public Sub Open ()

Implementaciones

Excepciones

No se puede abrir una conexión sin especificar un servidor u origen de datos.Cannot open a connection without specifying a data source or server.

oor

La conexión ya está abierta.The connection is already open.

Se produjo un error de nivel de conexión mientras se abría la conexión.A connection-level error occurred while opening the connection. Si la propiedad Number contiene el valor 18487 o 18488, indica que la contraseña especificada expiró o debe restablecerse.If the Number property contains the value 18487 or 18488, this indicates that the specified password has expired or must be reset. Vea el método ChangePassword(String, String) para más información.See the ChangePassword(String, String) method for more information.

La etiqueta <system.data.localdb> en el archivo app.config tiene elementos no válidos o desconocidos.The <system.data.localdb> tag in the app.config file has invalid or unknown elements.

Hay dos entradas con el mismo nombre en la sección <localdbinstances>.There are two entries with the same name in the <localdbinstances> section.

Ejemplos

En el ejemplo siguiente se crea un SqlConnection, se abre y se muestran algunas de sus propiedades.The following example creates a SqlConnection, opens it, and displays some of its properties. La conexión se cierra automáticamente al final del bloque de using.The connection is automatically closed at the end of the using block.

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);
    }
}
Private Sub OpenSqlConnection(ByVal connectionString As String)
    Using connection As New SqlConnection(connectionString)
        connection.Open()
        Console.WriteLine("ServerVersion: {0}", connection.ServerVersion)
        Console.WriteLine("State: {0}", connection.State)
    End Using
End Sub

Comentarios

El SqlConnection dibuja una conexión abierta desde el grupo de conexiones, si hay alguna disponible.The SqlConnection draws an open connection from the connection pool if one is available. De lo contrario, establece una nueva conexión con una instancia de SQL Server.Otherwise, it establishes a new connection to an instance of SQL Server.

Nota

Si el SqlConnection sale del ámbito, no se cierra.If the SqlConnection goes out of scope, it is not closed. Por lo tanto, debe cerrar explícitamente la conexión llamando a Close.Therefore, you must explicitly close the connection by calling Close.

Nota

Si especifica un número de puerto distinto de 1433 cuando está intentando conectarse a una instancia de SQL Server y usando un protocolo distinto de TCP/IP, se produce un error en el método Open.If you specify a port number other than 1433 when you are trying to connect to an instance of SQL Server and using a protocol other than TCP/IP, the Open method fails. Para especificar un número de puerto distinto de 1433, incluya "Server = MachineName, número de puerto" en la cadena de conexión y use el protocolo TCP/IP.To specify a port number other than 1433, include "server=machinename,port number" in the connection string, and use the TCP/IP protocol.

Nota

El proveedor de datos de .NET Framework para SQL Server requiere el permiso de seguridad con "permite llamadas a ensamblados no administrados" habilitado (SecurityPermission con SecurityPermissionFlag establecido en UnmanagedCode) para abrir un SqlConnection con la depuración de SQL habilitada.The .NET Framework Data Provider for SQL Server requires the Security permission with "Allows calls to unmanaged assemblies" enabled (SecurityPermission with SecurityPermissionFlag set to UnmanagedCode) to open a SqlConnection with SQL Debugging enabled.

Se aplica a

Consulte también: