DbConnectionStringBuilder.Add(String, Object) Methode

  • Referenz

Definition

Namespace:
System.Data.Common
Assembly:
System.Data.Common.dll
Assembly:
System.Data.dll
Assembly:
netstandard.dll

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 ein neues DbConnectionStringBuilder element erstellt und hinzugefügt. Der Code veranschaulicht auch das Überschreiben eines vorhandenen Elements mithilfe der Add Methode und enthält einen kommentierten Block, der einen ArgumentNullExceptionauslösen würde.

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 Sie den Wert eines Schlüssels festlegen, der im Wörterbuch nicht vorhanden ist. Beispiel: myCollection["myNonexistentKey"] = myValue.

Durch Aufrufen der Add Methode wird ein Nullschlüssel (Nothingin Visual Basic) ausgelöstArgumentNullException. Beim Aufrufen der Add Methode wird jedoch durch Übergeben eines NULL-Werts das Schlüssel-Wert-Paar entfernt.

Gilt für:

Siehe auch