SqlConnection.Open Метод

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Исходный код:
System.Data.SqlClient.notsupported.cs

Открывает подключение к базе данных с параметрами свойств, заданными параметром ConnectionString.

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

Реализации

Open()

Исключения

InvalidOperationException

Не удается открыть подключение, не указывая источник данных или сервер.

или

Подключение уже открыто.

SqlException

При открытии подключения произошла ошибка уровня подключения. Number Если свойство содержит значение 18487 или 18488, это означает, что указанный пароль истек или должен быть сброшен. Дополнительные сведения см. в методе ChangePassword(String, String) .

Тег <system.data.localdb> в файле app.config содержит недопустимые или неизвестные элементы.

ConfigurationErrorsException

В разделе есть две записи с одинаковым именем <localdbinstances> .

Примеры

В следующем примере создается SqlConnection, открывается и отображаются некоторые его свойства. Подключение автоматически закрывается в конце using блока.

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 наличии открытого подключения из пула подключений создается открытое подключение. В противном случае он устанавливает новое подключение к экземпляру SQL Server.

Note

Если область SqlConnection выходит из области, она не закрывается. Поэтому необходимо явно закрыть подключение путем вызова Close.

Note

Если вы указываете номер порта, отличный от 1433 при попытке подключиться к экземпляру SQL Server и используя протокол, отличный от TCP/IP, метод Open завершается ошибкой. Чтобы указать номер порта, отличный от 1433, добавьте "server=machinename", номер порта в строка подключения и используйте протокол TCP/IP.

Note

Data Provider платформы .NET для SQL Server требует разрешения безопасности с включенным параметром "Разрешить вызовы неуправляемых сборок" (SecurityPermission с параметром SecurityPermissionFlag задано значение UnmanagedCode), чтобы открыть SqlConnection с включенной отладкой SQL.

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

См. также раздел