SqlConnection.ConnectionString Eigenschaft

public:
 virtual property System::String ^ ConnectionString { System::String ^ get(); void set(System::String ^ value); };

[System.ComponentModel.SettingsBindable(true)]
public override string ConnectionString { get; set; }

public override string ConnectionString { get; set; }

[<System.ComponentModel.SettingsBindable(true)>]
member this.ConnectionString : string with get, set

member this.ConnectionString : string with get, set

Public Overrides Property ConnectionString As String

Eigenschaftswert

Die Verbindungszeichenfolge, die den Namen der Quelldatenbank und weitere für das Herstellen der Anfangsverbindung erforderliche Parameter enthält. Der Standardwert ist eine leere Zeichenfolge.

Attribute

SettingsBindableAttribute

Ausnahmen

Beispiele

Im folgenden Beispiel wird ein SqlConnection erstellt und die ConnectionString -Eigenschaft festgelegt, bevor die Verbindung geöffnet wird.

using Microsoft.Data.SqlClient;

class Program
{
    static void Main()
    {
        OpenSqlConnection();
        Console.ReadLine();
    }

    private static void OpenSqlConnection()
    {
        string connectionString = GetConnectionString();

        using (SqlConnection connection = new SqlConnection())
        {
            connection.ConnectionString = connectionString;

            connection.Open();

            Console.WriteLine("State: {0}", connection.State);
            Console.WriteLine("ConnectionString: {0}",
                connection.ConnectionString);
        }
    }

    static private string GetConnectionString()
    {
        // To avoid storing the connection string in your code, 
        // you can retrieve it from a configuration file.
        return "Data Source=MSSQL1;Initial Catalog=AdventureWorks;"
            + "Integrated Security=true;";
    }
}

Hinweise

ähnelt ConnectionString einer OLE DB-Verbindungszeichenfolge, ist aber nicht identisch. Im Gegensatz zu OLE DB oder ADO ist die zurückgegebene Verbindungszeichenfolge identisch mit dem Benutzersatz ConnectionString, abzüglich der Sicherheitsinformationen, wenn der Wert Persist Security Info auf false (Standard) festgelegt ist. Der .NET Framework-Datenanbieter für SQL Server wird das Kennwort nicht in einem Verbindungszeichenfolge beibehalten oder zurückgeben, es sei denn, Sie legen Sicherheitsinformationen beibehalten auf festtrue.
Sie können die ConnectionString -Eigenschaft verwenden, um eine Verbindung mit einer Datenbank herzustellen. Das folgende Beispiel veranschaulicht eine typische Verbindungszeichenfolge.

"Persist Security Info=False;Integrated Security=true;Initial Catalog=Northwind;server=(local)"  

Verwenden Sie das neue SqlConnectionStringBuilder , um zur Laufzeit gültige Verbindungszeichenfolgen zu erstellen. Weitere Informationen finden Sie in Connection String Builders (Verbindungszeichenfolgengeneratoren).

Die ConnectionString -Eigenschaft kann nur festgelegt werden, wenn die Verbindung geschlossen wird. Viele der Verbindungszeichenfolge-Werte verfügen über entsprechende schreibgeschützte Eigenschaften. Wenn die Verbindungszeichenfolge festgelegt ist, werden diese Eigenschaften aktualisiert, es sei denn, es wird ein Fehler erkannt. In diesem Fall wird keine der Eigenschaften aktualisiert. SqlConnection -Eigenschaften geben nur die Einstellungen zurück, die ConnectionStringin enthalten sind.

Um eine Verbindung mit einem lokalen Computer herzustellen, geben Sie "(local)" für den Server an. Wenn kein Servername angegeben wird, wird versucht, auf dem lokalen Computer eine Verbindung mit der Standard-instance herzustellen.

Beim Zurücksetzen von ConnectionString für eine geschlossene Verbindung werden alle Verbindungszeichenfolge Werte (und zugehörige Eigenschaften) einschließlich des Kennworts zurückgesetzt. Wenn Sie beispielsweise eine Verbindungszeichenfolge festlegen, die "Database= AdventureWorks" enthält, und setzen Sie dann die Verbindungszeichenfolge auf "Data Source=myserver; Integrated Security=true", ist die Database Eigenschaft nicht mehr auf "AdventureWorks" festgelegt.

Die Verbindungszeichenfolge wird unmittelbar nach dem Festlegen analysiert. Wenn beim Analysieren Syntaxfehler gefunden werden, wird eine Laufzeit-Ausnahme wie ArgumentExceptiongeneriert. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das Basisformat eines Verbindungszeichenfolge enthält eine Reihe von Schlüsselwort (keyword)-Wert-Paaren, die durch Semikolons getrennt sind. Ein Gleichheitszeichen (=) verbindet jedes Schlüsselwort mit seinem Wert. Um Werte einzuschließen, die ein Semikolon, ein einfaches Anführungszeichen oder ein doppeltes Anführungszeichen enthalten, muss der Wert in doppelte Anführungszeichen eingeschlossen werden. Wenn der Wert sowohl ein Semikolon als auch ein doppeltes Anführungszeichen enthält, kann der Wert in einfache Anführungszeichen eingeschlossen werden. Das einfache Anführungszeichen ist auch nützlich, wenn der Wert mit einem doppelten Anführungszeichen beginnt. Umgekehrt kann das doppelte Anführungszeichen verwendet werden, wenn der Wert mit einem einfachen Anführungszeichen beginnt. Wenn der Wert sowohl einfache als auch doppelte Anführungszeichen enthält, muss das Zum Einschließen des Werts verwendete Anführungszeichen jedes Mal verdoppelt werden, wenn er innerhalb des Werts auftritt.

Um vorangehende oder nachfolgende Leerzeichen in den Zeichenfolgenwert einzuschließen, muss der Wert entweder in einfache Anführungszeichen oder doppelte Anführungszeichen eingeschlossen werden. Alle führenden oder nachfolgenden Leerzeichen um ganzzahlige, boolesche oder aufgezählte Werte werden ignoriert, auch wenn sie in Anführungszeichen eingeschlossen sind. Leerzeichen innerhalb eines Zeichenfolgenliterals Schlüsselwort (keyword) oder -Werts werden jedoch beibehalten. Einfache oder doppelte Anführungszeichen können innerhalb eines Verbindungszeichenfolge ohne Trennzeichen verwendet werden (z. B. Data Source= my'Server oder Data Source= my"Server), es sei denn, ein Anführungszeichen ist das erste oder letzte Zeichen im Wert.

Bei Schlüsselwörtern wird die Groß-/Kleinschreibung nicht beachtet.

In der folgenden Tabelle sind die gültigen Namen für Schlüsselwort (keyword) Werte in der ConnectionStringaufgeführt.

Die folgende Liste enthält die gültigen Namen für Verbindungspoolingwerte innerhalb von ConnectionString. Weitere Informationen finden Sie unter SQL Server-Verbindungspooling (ADO.NET).

• Verbindungslebensdauer (oder Lastenausgleichstimeout)

• Enlist

• Max Pool Size

• Min Pool Size

• Pooling

Wenn Sie Schlüsselwort (keyword)- oder Verbindungspoolingwerte festlegen, die einen booleschen Wert erfordern, können Sie "ja" anstelle von "true" und "nein" anstelle von "false" verwenden. Ganzzahlige Werte werden als Zeichenfolgen dargestellt.

Gilt für: