SqlConnection.Open Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ö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
Ausnahmen
Ohne Angabe einer Datenquelle oder eines Servers kann keine Verbindung geöffnet werden.
oder
Die Verbindung ist bereits geöffnet.
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.
Im <localdbinstances>
-Abschnitt sind zwei Einträge mit demselben Namen vorhanden.
Beispiele
Im folgenden Beispiel wird ein SqlConnection, öffnet es und zeigt einige seiner Eigenschaften an. 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
Die 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.
Hinweis
Wenn der SqlConnection Bereich nicht abgeschlossen ist, wird er 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 Instanz von 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=machinename,port number" in das Verbindungszeichenfolge ein, und verwenden Sie das TCP/IP-Protokoll.
Hinweis
Die .NET Framework Datenanbieter für SQL Server erfordert die Sicherheitsberechtigung mit aktivierten "Ermöglicht Aufrufen von nicht verwalteten Assemblys" (SecurityPermissionmit Festgelegt auf UnmanagedCode
) zum Öffnen eines SqlConnection mit SQL Debugging aktivierten SecurityPermissionFlag Debuggings.