SqlConnection.Open Metódus

Definíció

Névtér:
System.Data.SqlClient
Szerelvény:
System.Data.SqlClient.dll
Szerelvény:
System.Data.dll
Forrás:
System.Data.SqlClient.notsupported.cs

Megnyílik egy adatbázis-kapcsolat a megadott tulajdonságbeállításokkal 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 ()

Megvalósítás

Open()

Kivételek

InvalidOperationException

Adatforrás vagy kiszolgáló megadása nélkül nem lehet kapcsolatot megnyitni.

vagy

A kapcsolat már meg van nyitva.

SqlException

Kapcsolatszintű hiba történt a kapcsolat megnyitásakor. Ha a Number tulajdonság az 18487 vagy 18488 értéket tartalmazza, az azt jelzi, hogy a megadott jelszó lejárt, vagy alaphelyzetbe kell állítani. További információért tekintse meg a ChangePassword(String, String) metódust.

A <system.data.localdb> app.config fájlban lévő címke érvénytelen vagy ismeretlen elemeket tartalmaznak.

ConfigurationErrorsException

A szakaszban két azonos nevű <localdbinstances> bejegyzés található.

Példák

Az alábbi példa létrehoz egy SqlConnection, majd megnyitja azt, és megjeleníti annak néhány tulajdonságát. A kapcsolat automatikusan bezárul a using blokk végén.

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

Megjegyzések

A SqlConnection kapcsolatkészletből nyitott kapcsolatot von le, ha van ilyen. Ellenkező esetben új kapcsolatot hoz létre a SQL Server egy példányával.

Note

Ha a SqlConnection hatókörön kívül esik, az nincs lezárva. Ezért a hívással explicit módon be kell zárnia Closea kapcsolatot.

Note

Ha az 1433-nál eltérő portszámot ad meg, amikor SQL Server egy példányához próbál csatlakozni, és a TCP/IP protokolltól eltérő protokollt használ, a Open metódus meghiúsul. Az 1433-nál eltérő portszám megadásához adja meg a "server=machinename,port number" értéket a kapcsolati karakterlánc, és használja a TCP/IP protokollt.

Note

A SQL Server .NET-keretrendszer Data Provider a "Nem felügyelt szerelvények hívásainak engedélyezése" beállítású biztonsági engedélyt igényel (SecurityPermissionSecurityPermissionFlag beállítása UnmanagedCode) a SqlConnection sql-hibakeresés engedélyezésével.

A következőre érvényes:

Lásd még