SqlConnection.Open Método

Definição

Espaço de Nomes:
System.Data.SqlClient
Assemblagem:
System.Data.dll

Abre uma ligação à base de dados com as definiçõ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 ligação sem especificar uma fonte de dados ou servidor.

ou

A ligação já está aberta.

SqlException

Ocorreu um erro ao nível da ligação durante a abertura da ligação. Se a Number propriedade contiver o valor 18487 ou 18488, isto indica que a palavra-passe especificada expirou ou deve ser redefinida. Consulte o ChangePassword(String, String) método para mais informações.

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

ConfigurationErrorsException

Existem duas entradas com o mesmo nome na <localdbinstances> secção.

Exemplos

O exemplo seguinte cria um SqlConnection, abre-o e apresenta algumas das suas propriedades. A ligação é automaticamente fechada 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

Observações

A ligação SqlConnection fica aberta do conjunto de ligações, se houver disponível. Caso contrário, estabelece uma nova ligação a uma instância do SQL Server.

Note

Se sair SqlConnection do âmbito, não está fechado. Portanto, deve fechar explicitamente a ligação chamando Close.

Note

Se especificar um número de porta diferente de 1433 ao tentar ligar-se a uma instância de SQL Server e usar um protocolo diferente do TCP/IP, o método Open falha. Para especificar um número de porta diferente de 1433, inclua "server=machinename,port number" na cadeia de ligação e use o protocolo TCP/IP.

Note

O .NET Framework Data Provider para SQL Server requer a permissão de Segurança com "Permite chamadas a assemblies não geridas" ativado (SecurityPermission com SecurityPermissionFlag definido para UnmanagedCode) para abrir um SqlConnection com a depuração SQL ativada.

Aplica-se a

Ver também