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 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.