SqlConnection.ConnectionString Eigenschaft

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

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

public override string ConnectionString { get; set; }

[System.Data.DataSysDescription("SqlConnection_ConnectionString")]
public string ConnectionString { get; set; }

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

member this.ConnectionString : string with get, set

[<System.Data.DataSysDescription("SqlConnection_ConnectionString")>]
member this.ConnectionString : string with get, set

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

Public Overrides Property ConnectionString As String

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

Implementiert

Attribute

DataSysDescriptionAttribute SettingsBindableAttribute

Ausnahmen

Beispiele

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

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

Private Sub OpenSqlConnection()
    Dim connectionString As String = GetConnectionString()

    Using connection As New SqlConnection()

        connection.ConnectionString = connectionString

        connection.Open()

        Console.WriteLine("State: {0}", connection.State)
        Console.WriteLine("ConnectionString: {0}", _
            connection.ConnectionString)
    End Using
End Sub

Private Function GetConnectionString() As String
    ' To avoid storing the connection string in your code,  
    ' you can retrieve it from a configuration file.
    Return "Data Source=MSSQL1;Database=AdventureWorks;" _
      & "Integrated Security=true;"
End Function

Hinweise

Der ConnectionString ähnelt einer OLE DB-Verbindungszeichenfolge, ist aber nicht identisch. Im Gegensatz zu OLE DB oder ADO ist die zurückgegebene Verbindungszeichenfolge mit dem Benutzersatz ConnectionStringidentisch, abzüglich der Sicherheitsinformationen, wenn der Wert Persist Security Info auf false (Standard) festgelegt ist. Der .NET Framework-Datenanbieter für SQL Server speichert oder gibt das Kennwort nicht in einer Verbindungszeichenfolge zurück, es sei denn, Sie legen Persist Security Info 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 gültige Verbindungszeichenfolgen zur Laufzeit 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 Verbindungszeichenfolgenwerte 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 eine Verbindung mit der Standardinstanz auf dem lokalen Computer versucht.

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

Die Verbindungszeichenfolge wird sofort nach dem Festlegen analysiert. Wenn beim Analysieren Syntaxfehler gefunden werden, wird eine Laufzeit-Ausnahme, z ArgumentException. B. , generiert. Andere Fehler können nur gefunden werden, wenn versucht wird, die Verbindung zu öffnen.

Das Grundlegende Format einer Verbindungszeichenfolge umfasst eine Reihe von Schlüsselwort-Wert-Paaren, die durch Semikolons getrennt sind. Ein Gleichheitszeichen (=) verbindet jedes Schlüsselwort mit seinem Wert. Um Werte einzuschließen, die ein Semikolon, Ein-Anführungszeichen oder doppeltes Anführungszeichen enthalten, muss der Wert in doppelte Anführungszeichen eingeschlossen werden. Wenn der Wert sowohl ein Semikolon als auch ein Zeichen mit doppeltem 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 Zeichen mit doppeltem Anführungszeichen beginnt. Umgekehrt kann das doppelte Anführungszeichen verwendet werden, wenn der Wert mit einem einzigen Anführungszeichen beginnt. Wenn der Wert sowohl Anführungszeichen als auch Anführungszeichen mit doppeltem Anführungszeichen enthält, muss das Anführungszeichen, das zum Einschließen des Werts verwendet wird, 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 Zeichenfolgenliteralschlüsselworts oder -werts werden jedoch beibehalten. Einzelne oder doppelte Anführungszeichen können innerhalb einer Verbindungszeichenfolge ohne Trennzeichen (z. B. Data Source= my'Server oder Data Source= my"Server) verwendet werden, 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üsselwortwerte innerhalb des 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- 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:

Weitere Informationen

• ADO.NET Managed Provider und DataSet Developer Center
• Verbindungszeichenfolgen in ADO.NET
• SQL Server-Verbindungspooling (ADO.NET)
• Herstellen einer Verbindung mit einer Datenquelle in ADO.NET
• Übersicht über ADO.NET