Freigeben über


DbConnectionStringBuilder.Add(String, Object) Methode

Definition

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

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

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.

Gilt für:

Weitere Informationen