SqlConnection.Open Methode

  • Referenz

Definition

Namespace:
System.Data.SqlClient
Assembly:
System.Data.SqlClient.dll
Assembly:
System.Data.dll
Paket:
System.Data.SqlClient v4.8.6

Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.

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 ()

Implementiert

Open()

Ausnahmen

InvalidOperationException

Ohne Angabe einer Datenquelle oder eines Servers kann keine Verbindung geöffnet werden.

oder

Die Verbindung ist bereits geöffnet.

SqlException

Beim Öffnen der Verbindung ist ein Fehler auf Verbindungsebene aufgetreten. Wenn die Number-Eigenschaft den Wert 18487 oder 18488 enthält, weist dies darauf hin, dass das angegebene Kennwort abgelaufen ist oder zurückgesetzt werden muss. Weitere Informationen finden Sie unter der ChangePassword(String, String) -Methode.

Das <system.data.localdb>-Tag in der Datei „app.config“ enthält ungültige oder unbekannte Elemente.

ConfigurationErrorsException

Im <localdbinstances>-Abschnitt sind zwei Einträge mit demselben Namen vorhanden.

Beispiele

Im folgenden Beispiel wird ein SqlConnectionerstellt, geöffnet und einige seiner Eigenschaften angezeigt. Die Verbindung wird automatisch am Ende des using Blocks 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

Der SqlConnection zeichnet eine offene Verbindung aus dem Verbindungspool, falls verfügbar. Andernfalls wird eine neue Verbindung mit einer instance SQL Server hergestellt.

Hinweis

Wenn der SqlConnection außerhalb des Gültigkeitsbereichs liegt, wird es nicht geschlossen. Daher müssen Sie die Verbindung explizit schließen, indem Sie aufrufen Close.

Hinweis

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

Hinweis

Der .NET Framework-Datenanbieter für SQL Server erfordert die Sicherheitsberechtigung mit aktiviertem "Aufrufe nicht verwalteter Assemblys zulässt" (SecurityPermissionmit festgelegt auf UnmanagedCode), um eine SqlConnection mit aktiviertem SQL-Debuggen SecurityPermissionFlag zu öffnen.

Gilt für:

Weitere Informationen