DbConnectionStringBuilder.Add(String, Object) Methode

Definition

Namespace:

System.Data.Common

Assembly:

System.Data.Common.dll

Quelle:

DbConnectionStringBuilder.cs

Fügt dem DbConnectionStringBuilder einen Eintrag mit dem angegebenen Schlüssel und Wert hinzu.

public:
 void Add(System::String ^ keyword, System::Object ^ value);

public void Add (string keyword, object value);

member this.Add : string * obj -> unit

Public Sub Add (keyword As String, value As Object)

Parameter

keyword

String

Der DbConnectionStringBuilder hinzuzufügende Schlüssel.

value

Object

Der Wert des angegebenen Schlüssels.

Ausnahmen

ArgumentNullException

keyword ist ein NULL-Verweis (Nothing in Visual Basic).

NotSupportedException

DbConnectionStringBuilder ist schreibgeschützt.

- oder -

DbConnectionStringBuilder hat eine feste Größe.

Beispiele

Im folgenden Beispiel wird eine neue DbConnectionStringBuilder erstellt und Elemente hinzugefügt. Der Code veranschaulicht auch das Überschreiben eines vorhandenen Elements mithilfe der Add -Methode und enthält einen kommentierten Block, der einen ArgumentNullExceptionauslöst.

Hinweis

Das Beispiel umfasst ein Kennwort zur Veranschaulichung der Funktion von DbConnectionStringBuilder mit Verbindungszeichenfolgen. In den Anwendungen wird die Verwendung der Windows-Authentifizierung empfohlen. Wenn Sie ein Kennwort verwenden müssen, schließen Sie kein hartcodiertes Kennwort in die Anwendung ein.

static void Main()
{
    try
    {
        DbConnectionStringBuilder builder =
            new DbConnectionStringBuilder();
        builder.Add("Data Source", "ServerName");
        builder.Add("Initial Catalog", "TheDatabase");
        builder.Add("User ID", "UserName");
        builder.Add("Password", "*******");
        builder.Add("Command Logging", false);

        // Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName");

        // The following code would trigger
        // an ArgumentNullException:
        // builder.Add(null, "Some Value");

        Console.WriteLine(builder.ConnectionString);
    }
    catch (ArgumentNullException)
    {
        Console.WriteLine("Null key values are not allowed.");
    }

    Console.WriteLine("Press Enter to continue.");
    Console.ReadLine();
}

Sub Main()
    Try
        Dim builder As New DbConnectionStringBuilder
        builder.Add("Data Source", "ServerName")
        builder.Add("Initial Catalog", "TheDatabase")
        builder.Add("User ID", "UserName")
        builder.Add("Password", "*******")
        builder.Add("Command Logging", False)

        ' Overwrite the existing "User ID" value.
        builder.Add("User ID", "NewUserName")

        ' The following code would trigger 
        ' an ArgumentNullException.
        ' builder.Add(Nothing, "Some Value")

        Console.WriteLine(builder.ConnectionString)

    Catch ex As ArgumentNullException
        Console.WriteLine("Null key values are not allowed.")
    End Try

    Console.WriteLine("Press Enter to continue.")
    Console.ReadLine()
End Sub

Hinweise

Die Item[] -Eigenschaft kann auch verwendet werden, um neue Elemente hinzuzufügen, indem der Wert eines Schlüssels festgelegt wird, der im Wörterbuch nicht vorhanden ist. Beispiel: myCollection["myNonexistentKey"] = myValue.

Durch Das Aufrufen der Add -Methode durch Übergeben eines NULL-Schlüssels (Nothing in Visual Basic) wird ein ArgumentNullExceptionausgelöst. Durch Das Aufrufen der Add Methode durch Übergeben eines NULL-Werts wird jedoch das Schlüssel-Wert-Paar entfernt.

Weitere Informationen

• Verbindungszeichenfolgen in ADO.NET
• Übersicht über ADO.NET