Freigeben über

SqlConnection.Open-Methode

Öffnet eine Datenbankverbindung mit den durch ConnectionString angegebenen Eigenschafteneinstellungen.

Namespace: System.Data.SqlClient
Assembly: System.Data (in system.data.dll)

Syntax

'Declaration
Public Overrides Sub Open
'Usage
Dim instance As SqlConnection

instance.Open

public override void Open ()

public:
virtual void Open () override

public void Open ()

public override function Open ()

Ausnahmen

Ausnahmetyp Bedingung

InvalidOperationException

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

oder

Die Verbindung ist bereits offen.

SqlException

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

Hinweise

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

Hinweis

SqlConnection wird beim Verlassen des Gültigkeitsbereichs nicht geschlossen. Daher müssen Sie die Verbindung explizit schließen, indem Sie Close aufrufen.

Hinweis

Wenn Sie beim Verbindungsaufbau zu einer SQL Server-Instanz unter Verwendung eines anderen Protokolls als TCP/IP nicht die Anschlussnummer 1433 festlegen, schlägt die Open-Methode fehl. Um eine andere Anschlussnummer als 1433 anzugeben, fügen Sie in die Verbindungszeichenfolge "server=machinename,port number" ein und verwenden das TCP/IP-Protokoll.

Hinweis

Der .NET Framework-Datenanbieter für SQL Server fordert eine Sicherheitsberechtigung an, in der "Aufrufen nicht verwalteter Assemblys zulassen" aktiviert ist (SecurityPermission ist mit SecurityPermissionFlag auf UnmanagedCode festgelegt), um eine SqlConnection mit aktiviertem SQL-Debuggen zu öffnen.

Beispiel

Im folgenden Beispiel wird eine SqlConnection erstellt und geöffnet, und einige ihrer Eigenschaften werden angezeigt. Die Verbindung wird am Ende des using-Blocks automatisch geschlossen.

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

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);
    }
}

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

SqlConnection-Klasse
SqlConnection-Member
System.Data.SqlClient-Namespace

Weitere Ressourcen

Verbinden und Abrufen von Daten mit ADO.NET
Verwenden des .NET Framework-Datenanbieters für SQL Server

  • Last updated on