SqlConnection.Open Método

Definição

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Abre uma conexão de banco de dados com as configurações de propriedade especificadas pelo ConnectionString.

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

Implementações

Open()

Exceções

InvalidOperationException

Não é possível abrir uma conexão sem especificar uma fonte de dados ou um 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 Number propriedade contiver o valor 18487 ou 18488, isso indicará que a senha especificada expirou ou deve ser redefinida. Consulte o ChangePassword(String, String) método para obter mais informações.

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

ConfigurationErrorsException

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

Exemplos

O exemplo a seguir cria um SqlConnection, abre-o 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

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

Note

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

Note

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 método Open 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.

Note

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

Aplica-se a

Confira também