SqlConnection.Open Metoda

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Zdroj:
System.Data.SqlClient.notsupported.cs

Otevře připojení k databázi s nastavením vlastnosti určené parametrem 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 ()

Implementuje

Open()

Výjimky

InvalidOperationException

Nelze otevřít připojení bez zadání zdroje dat nebo serveru.

nebo

Připojení je již otevřené.

SqlException

Při otevírání připojení došlo k chybě na úrovni připojení. Number Pokud vlastnost obsahuje hodnotu 18487 nebo 18488, znamená to, že zadané heslo vypršelo nebo musí být resetováno. Další informace najdete v ChangePassword(String, String) metodě.

Značka <system.data.localdb> v souboru app.config obsahuje neplatné nebo neznámé prvky.

ConfigurationErrorsException

V oddílu <localdbinstances> jsou dvě položky se stejným názvem.

Příklady

Následující příklad vytvoří SqlConnection, otevře ho a zobrazí některé jeho vlastnosti. Připojení se automaticky zavře na konci using bloku.

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

Poznámky

Pokud SqlConnection je k dispozici, nakreslí z fondu připojení otevřené připojení. V opačném případě vytvoří nové připojení k instanci SQL Server.

Note

SqlConnection Pokud je rozsah mimo rozsah, nezavře se. Proto musíte připojení explicitně zavřít voláním Close.

Note

Pokud při pokusu o připojení k instanci SQL Server a použití jiného protokolu než TCP/IP zadáte jiné číslo portu než 1433, metoda Open selže. Pokud chcete zadat jiné číslo portu než 1433, do připojovací řetězec zadejte "server=název_počítače", číslo portu a použijte protokol TCP/IP.

Note

Rozhraní .NET Framework Zprostředkovatel dat pro SQL Server vyžaduje, aby oprávnění zabezpečení s povolenou možností Povolit volání nespravovaných sestavení (SecurityPermission s SecurityPermissionFlag nastavenou na UnmanagedCode) k otevření SqlConnection s povoleným laděním SQL.

Platí pro

Viz také