SqlConnection.Open Метод

  • Ссылка

Определение

Пространство имен:
System.Data.SqlClient
Сборка:
System.Data.SqlClient.dll
Сборка:
System.Data.dll
Пакет:
System.Data.SqlClient v4.8.6

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

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

or

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

SqlException

При открытии подключения произошла ошибка на уровне подключения. Если свойство Number содержит значение 18 487 или 18 488, это означает, что действие указанного пароля истекло или что пароль должен быть сброшен. Дополнительные сведения см. в описании метода 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.

Примечание

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

Примечание

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

Примечание

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

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

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