SqlConnection.Open Método

Definição

Abre uma conexão de banco de dados com as configurações de propriedade especificadas pelo ConnectionString.Opens a database connection with the property settings specified by the ConnectionString.

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

Implementações

Exceções

Não é possível abrir uma conexão sem especificar uma fonte de dados ou servidor.Cannot open a connection without specifying a data source or server.

ouor

A conexão já está aberta.The connection is already open.

Ocorreu um erro no nível da conexão ao abrir a conexão.A connection-level error occurred while opening the connection. Se a propriedade Number contiver o valor 18487 ou 18488, isso indicará que a senha especificada expirou ou precisa ser redefinida.If the Number property contains the value 18487 or 18488, this indicates that the specified password has expired or must be reset. Consulte o método ChangePassword(String, String) para obter mais informações.See the ChangePassword(String, String) method for more information.

A marca <system.data.localdb> no arquivo app.config tem elementos inválidos ou desconhecidos.The <system.data.localdb> tag in the app.config file has invalid or unknown elements.

Há duas entradas com o mesmo nome na seção <localdbinstances>.There are two entries with the same name in the <localdbinstances> section.

Exemplos

O exemplo a seguir cria um SqlConnection, abre-o e exibe algumas de suas propriedades.The following example creates a SqlConnection, opens it, and displays some of its properties. A conexão é fechada automaticamente no final do bloco de using.The connection is automatically closed at the end of the using block.

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.The SqlConnection draws an open connection from the connection pool if one is available. Caso contrário, ele estabelece uma nova conexão com uma instância do SQL Server.Otherwise, it establishes a new connection to an instance of SQL Server.

Observação

Se o SqlConnection sair do escopo, ele não será fechado.If the SqlConnection goes out of scope, it is not closed. Portanto, você deve fechar a conexão explicitamente chamando Close.Therefore, you must explicitly close the connection by calling Close.

Observação

Se você especificar um número de porta diferente de 1433 quando estiver tentando se conectar a uma instância do SQL Server e usar um protocolo diferente de TCP/IP, o método Open falhará.If you specify a port number other than 1433 when you are trying to connect to an instance of SQL Server and using a protocol other than TCP/IP, the Open method fails. Para especificar um número de porta diferente de 1433, inclua "Server = MachineName, número da porta" na cadeia de conexão e use o protocolo TCP/IP.To specify a port number other than 1433, include "server=machinename,port number" in the connection string, and use the TCP/IP protocol.

Observação

O Provedor de Dados .NET Framework para SQL Server requer a permissão de segurança com "permitir chamadas para assemblies não gerenciados" habilitado (SecurityPermission com SecurityPermissionFlag definido como UnmanagedCode) para abrir um SqlConnection com a depuração SQL habilitada.The .NET Framework Data Provider for SQL Server requires the Security permission with "Allows calls to unmanaged assemblies" enabled (SecurityPermission with SecurityPermissionFlag set to UnmanagedCode) to open a SqlConnection with SQL Debugging enabled.

Aplica-se a

Veja também