SqlConnection.Open Methode

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.dll

Öffnet eine Datenbankverbindung mit den eigenschafteneinstellungen, die durch die ConnectionString.

public:
 virtual void Open();
public:
 override void Open();
public void Open();
public override void Open();
abstract member Open : unit -> unit
override this.Open : unit -> unit
override this.Open : unit -> unit
Public Sub Open ()
Public Overrides Sub Open ()

Implementiert

Open()

Ausnahmen

InvalidOperationException

Eine Verbindung kann nicht geöffnet werden, ohne eine Datenquelle oder einen Server anzugeben.

oder

Die Verbindung ist bereits geöffnet.

SqlException

Fehler auf Verbindungsebene beim Öffnen der Verbindung. Wenn die Number Eigenschaft den Wert 18487 oder 18488 enthält, gibt dies an, dass das angegebene Kennwort abgelaufen ist oder zurückgesetzt werden muss. Weitere Informationen finden Sie in der ChangePassword(String, String) Methode.

Das <system.data.localdb> Tag in der app.config Datei weist ungültige oder unbekannte Elemente auf.

ConfigurationErrorsException

Es gibt zwei Einträge mit demselben Namen im <localdbinstances> Abschnitt.

Beispiele

Im folgenden Beispiel wird ein SqlConnectionObjekt erstellt, geöffnet und einige seiner Eigenschaften angezeigt. Die Verbindung wird am Ende des using Blocks automatisch geschlossen.

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

Hinweise

Das SqlConnection Zeichnet eine offene Verbindung aus dem Verbindungspool, wenn eine verfügbar ist. Andernfalls wird eine neue Verbindung mit einer Instanz von SQL Server hergestellt.

Note

Wenn der SqlConnection Bereich nicht mehr vorhanden ist, wird er nicht geschlossen. Daher müssen Sie die Verbindung explizit durch Aufrufen Closeschließen.

Note

Wenn Sie eine andere Portnummer als 1433 angeben, wenn Sie versuchen, eine Verbindung mit einer Instanz von SQL Server herzustellen und ein anderes Protokoll als TCP/IP zu verwenden, schlägt die methode Open fehl. Um eine andere Portnummer als 1433 anzugeben, schließen Sie "server=computername,port number" in die Verbindungszeichenfolge ein, und verwenden Sie das TCP/IP-Protokoll.

Note

Für das .NET Framework-Datenanbieter für SQL Server ist die Sicherheitsberechtigung mit aktivierten "Aufrufe an nicht verwaltete Assemblys zulassen" (SecurityPermission mit SecurityPermissionFlag auf UnmanagedCode festgelegt) erforderlich, um eine SqlConnection mit aktiviertem SQL-Debugging zu öffnen.

Gilt für:

Weitere Informationen