SqlConnection.Open Metoda

  • Reference

Definice

Obor názvů:
System.Data.SqlClient
Sestavení:
System.Data.SqlClient.dll
Sestavení:
System.Data.dll
Balíček:
System.Data.SqlClient v4.8.6

Otevře připojení k databázi s nastavením vlastnosti určeným 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řeno.

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 vypršela platnost zadaného hesla nebo se musí resetovat. Další informace najdete v ChangePassword(String, String) metodě .

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

ConfigurationErrorsException

Oddíl obsahuje dvě položky se stejným názvem <localdbinstances> .

Příklady

Následující příklad vytvoří objekt SqlConnection, otevře ho a zobrazí některé z jeho vlastností. Připojení se automaticky ukončí 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

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

Poznámka

Pokud přejde mimo SqlConnection rozsah, neuzavře se. Proto je nutné explicitně ukončit připojení voláním Close.

Poznámka

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

Poznámka

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

Platí pro

Viz také