SqlConnection.Open Método

  • Referência

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Pacote:
System.Data.SqlClient v4.8.6

Abre uma conexão de banco de dados com as configurações de propriedade especificadas pelo 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 ()

Implementações

Open()

Exceções

InvalidOperationException

Não é possível abrir uma conexão sem especificar uma fonte de dados ou servidor.

ou

A conexão já está aberta.

SqlException

Ocorreu um erro no nível da conexão ao abrir a conexão. Se a propriedade Number contiver o valor 18487 ou 18488, isso indicará que a senha especificada expirou ou precisa ser redefinida. Consulte o método ChangePassword(String, String) para obter mais informações.

A marca <system.data.localdb> no arquivo app.config tem elementos inválidos ou desconhecidos.

ConfigurationErrorsException

Há duas entradas com o mesmo nome na seção <localdbinstances>.

Exemplos

O exemplo a seguir cria um SqlConnection, o abre e exibe algumas de suas propriedades. A conexão é fechada automaticamente no final do using bloco.

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

Comentários

O SqlConnection desenha uma conexão aberta do pool de conexões se houver uma disponível. Caso contrário, ele estabelece uma nova conexão com uma instância de SQL Server.

Observação

Se o SqlConnection sair do escopo, ele não será fechado. Portanto, você deve fechar explicitamente a conexão chamando Close.

Observação

Se você especificar um número de porta diferente de 1433 quando estiver tentando se conectar a uma instância de SQL Server e usando um protocolo diferente de TCP/IP, o Open método falhará. Para especificar um número de porta diferente de 1433, inclua "server=machinename, port number" no cadeia de conexão e use o protocolo TCP/IP.

Observação

O provedor de dados .NET Framework para SQL Server requer a permissão segurança com "Permite chamadas para assemblies não gerenciados" habilitado (SecurityPermission com definido como UnmanagedCode) para abrir um SqlConnection com a Depuração de SQL SecurityPermissionFlag habilitada.

Aplica-se a

Confira também