SqlConnection.Open Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Открывает подключение к базе данных со значениями свойств, определяемыми объектом 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 ()Реализации
Исключения
Невозможно открыть подключение без указания источника данных или сервера.
or
Подключение уже открыто.
При открытии подключения произошла ошибка на уровне подключения. Если свойство Number содержит значение 18 487 или 18 488, это означает, что действие указанного пароля истекло или что пароль должен быть сброшен. Дополнительные сведения см. в описании метода ChangePassword(String, String) .
Тег <system.data.localdb> в файле app.config имеет недопустимые или неизвестные элементы.
В разделе <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.
