DbConnectionStringBuilder.Add(String, Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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.