SqlConnection.Open Methode

Definition

Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.Opens a database connection with the property settings specified by the ConnectionString.

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

Implementiert

Ausnahmen

Ohne Angabe einer Datenquelle oder eines Servers kann keine Verbindung geöffnet werden.Cannot open a connection without specifying a data source or server.

oderor

Die Verbindung ist bereits geöffnet.The connection is already open.

Beim Öffnen der Verbindung ist ein Fehler auf Verbindungsebene aufgetreten.A connection-level error occurred while opening the connection. 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.If the Number property contains the value 18487 or 18488, this indicates that the specified password has expired or must be reset. Weitere Informationen finden Sie unter der ChangePassword(String, String) -Methode.See the ChangePassword(String, String) method for more information.

Das <system.data.localdb>-Tag in der Datei „app.config“ enthält ungültige oder unbekannte Elemente.The <system.data.localdb> tag in the app.config file has invalid or unknown elements.

Im <localdbinstances>-Abschnitt sind zwei Einträge mit demselben Namen vorhanden.There are two entries with the same name in the <localdbinstances> section.

Beispiele

Im folgenden Beispiel wird eine SqlConnectionerstellt, geöffnet und einige ihrer Eigenschaften angezeigt.The following example creates a SqlConnection, opens it, and displays some of its properties. Die Verbindung wird am Ende des using Blocks automatisch geschlossen.The connection is automatically closed at the end of the using block.

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

Wenn eine Verbindung verfügbar ist, wird vom SqlConnection eine geöffnete Verbindung aus dem Verbindungspool gezeichnet.The SqlConnection draws an open connection from the connection pool if one is available. Andernfalls stellt Sie eine neue Verbindung mit einer Instanz von SQL Server her.Otherwise, it establishes a new connection to an instance of SQL Server.

Hinweis

Wenn der SqlConnection den Gültigkeitsbereich verlässt, wird er nicht geschlossen.If the SqlConnection goes out of scope, it is not closed. Daher müssen Sie die Verbindung explizit schließen, indem Sie Closeaufrufen.Therefore, you must explicitly close the connection by calling Close.

Hinweis

Wenn Sie eine andere Portnummer als 1433 angeben, wenn Sie versuchen, eine Verbindung mit einer Instanz von herzustellen SQL Server und ein anderes Protokoll als TCP/IP verwenden, schlägt die Methode Open fehl.If you specify a port number other than 1433 when you are trying to connect to an instance of SQL Server and using a protocol other than TCP/IP, the Open method fails. Wenn Sie eine andere Portnummer als 1433 angeben möchten, schließen Sie "Server = MachineName, Port Number" in die Verbindungs Zeichenfolge ein, und verwenden Sie das TCP/IP-Protokoll.To specify a port number other than 1433, include "server=machinename,port number" in the connection string, and use the TCP/IP protocol.

Hinweis

Die .NET Framework Datenanbieter für SQL Server erfordert die Sicherheits Berechtigung mit aktiviertem "Zulassen von Aufrufen von nicht verwalteten Assemblys" (SecurityPermission mit SecurityPermissionFlag auf UnmanagedCodefestgelegt), um eine SqlConnection mit aktiviertem SQL-Debuggen zu öffnen.The .NET Framework Data Provider for SQL Server requires the Security permission with "Allows calls to unmanaged assemblies" enabled (SecurityPermission with SecurityPermissionFlag set to UnmanagedCode) to open a SqlConnection with SQL Debugging enabled.

Gilt für:

Siehe auch