SqlConnection.Open Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Abre una conexión de base de datos con los valores de propiedad que especifica ConnectionString.
public:
override void Open();
public:
virtual void Open();
public override void Open ();
public void Open ();
override this.Open : unit -> unit
abstract member Open : unit -> unit
override this.Open : unit -> unit
Public Overrides Sub Open ()
Public Sub Open ()
Implementaciones
Excepciones
No se puede abrir una conexión sin especificar un servidor u origen de datos.
o
La conexión ya está abierta.
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.
Hay dos entradas con el mismo nombre en la sección <localdbinstances>
.
Ejemplos
En el ejemplo siguiente se crea un SqlConnection, se abre y se muestran algunas de sus propiedades. La conexión se cierra automáticamente al final del using
bloque.
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
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 llamando 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,número de puerto" en el 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.