SqlConnection.Open Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitabstract member Open : unit -> unit
override this.Open : unit -> unitPublic Overrides Sub Open ()Public Sub Open ()Implementações
Exceções
Não é possível abrir uma conexão sem especificar uma fonte de dados ou servidor.
ou
A conexão já está aberta.
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.
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.
