SqlConnection.Open Methode

Definition

Namespace:

Microsoft.Data.SqlClient

Assembly:

Microsoft.Data.SqlClient.dll

Paket:

Microsoft.Data.SqlClient v5.2.0

Überlädt

Open()	Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.
Open(SqlConnectionOverrides)	Öffnet eine Datenbankverbindung mit den von der ConnectionString angegebenen Eigenschafteneinstellungen.

Open()

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

public:
 override void Open();

public override void Open ();

override this.Open : unit -> unit

Public Overrides Sub 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 am Ende des using Blocks automatisch geschlossen.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

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

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Hinweise

Der SqlConnection zeichnet eine offene Verbindung aus dem Verbindungspool, sofern verfügbar. Andernfalls wird eine neue Verbindung mit einer Instanz von 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 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, fügen Sie "server=Computername,Portnummer" in die 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 ein SqlConnection mit aktiviertem SQL-Debuggen SecurityPermissionFlag zu öffnen.

Open(SqlConnectionOverrides)

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

public:
 void Open(Microsoft::Data::SqlClient::SqlConnectionOverrides overrides);

public void Open (Microsoft.Data.SqlClient.SqlConnectionOverrides overrides);

override this.Open : Microsoft.Data.SqlClient.SqlConnectionOverrides -> unit

Public Sub Open (overrides As SqlConnectionOverrides)

Parameter

overrides

SqlConnectionOverrides

Optionen zum Überschreiben des Standardmäßigen Verbindungsöffnungsverhaltens.

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 am Ende des using Blocks automatisch geschlossen.

using Microsoft.Data.SqlClient;

class Program1
{
    static void Main()
    {
        string s = GetConnectionString();

        OpenSqlConnection(s);
        Console.ReadLine();
    }

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

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file, using the 
        // System.Configuration.ConfigurationSettings.AppSettings property 
        return "Data Source=(local);Initial Catalog=AdventureWorks;"
            + "Integrated Security=SSPI;";
    }
}

Hinweise

Der SqlConnection zeichnet eine offene Verbindung aus dem Verbindungspool, sofern verfügbar. Andernfalls wird eine neue Verbindung mit einer Instanz von SQL Server hergestellt. Wenn Überschreibungen angegeben werden, wendet der erste offene Versuch die angegebenen Außerkraftsetzungen auf die geöffnete Aktion an.

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 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, fügen Sie "server=Computername,Portnummer" in die 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 ein SqlConnection mit aktiviertem SQL-Debuggen SecurityPermissionFlag zu öffnen.