SqlConnection.Open SqlConnection.Open SqlConnection.Open SqlConnection.Open Method

Определение

Открывает подключение к базе данных со значениями свойств, определяемыми объектом 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 ()

Реализации

Исключения

Невозможно открыть подключение без указания источника данных или сервера.Cannot open a connection without specifying a data source or server.

илиor

Подключение уже открыто.The connection is already open.

При открытии подключения произошла ошибка на уровне подключения.A connection-level error occurred while opening the connection. Если свойство Number содержит значение 18 487 или 18 488, это означает, что действие указанного пароля истекло или что пароль должен быть сброшен.If the Number property contains the value 18487 or 18488, this indicates that the specified password has expired or must be reset. Дополнительные сведения см. в описании метода ChangePassword(String, String) .See the ChangePassword(String, String) method for more information.

Тег <system.data.localdb> в файле app.config имеет недопустимые или неизвестные элементы.The <system.data.localdb> tag in the app.config file has invalid or unknown elements.

В разделе <localdbinstances> присутствуют две записи с одинаковым именем.There are two entries with the same name in the <localdbinstances> section.

Примеры

В следующем примере создается SqlConnection, открывается и отображаются некоторые его свойства.The following example creates a SqlConnection, opens it, and displays some of its properties. Соединение автоматически закрывается в конце 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

Комментарии

SqlConnection Отображает открытое соединение из пула подключений, если оно доступно.The SqlConnection draws an open connection from the connection pool if one is available. В противном случае он устанавливает новое соединение с экземпляром SQL Server.Otherwise, it establishes a new connection to an instance of SQL Server.

Примечание

Если объект SqlConnection выходит из области действия, он не закрывается.If the SqlConnection goes out of scope, it is not closed. Поэтому необходимо явно закрыть соединение путем вызова Close.Therefore, you must explicitly close the connection by calling Close.

Примечание

Если указать номер порта, отличный от 1433, при попытке подключиться к экземпляру SQL Server и использовать протокол, отличный от TCP/IP, Open метод завершается ошибкой.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. Чтобы указать номер порта, отличный от 1433, включите в строку подключения значение "Server = MachineName, номер порта" и используйте протокол 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.

Примечание

Поставщику данных .NET Framework для SQL Server требуется разрешение безопасности с параметром "допускает вызовыSecurityPermission неуправляемых сборок" (с SecurityPermissionFlag установленным значением UnmanagedCode) для открытия SqlConnection с включенной отладкой SQL.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.

Применяется к

Дополнительно