DbConnectionStringBuilder.Item[String] Eigenschaft
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.
Dient zum Abrufen oder Festlegen des Werts, der dem angegebenen Schlüssel zugeordnet ist.
public:
virtual property System::Object ^ default[System::String ^] { System::Object ^ get(System::String ^ keyword); void set(System::String ^ keyword, System::Object ^ value); };public virtual object this[string keyword] { get; set; }[System.ComponentModel.Browsable(false)]
public virtual object this[string keyword] { get; set; }member this.Item(string) : obj with get, set[<System.ComponentModel.Browsable(false)>]
member this.Item(string) : obj with get, setDefault Public Overridable Property Item(keyword As String) As ObjectParameter
- keyword
- String
Der Schlüssel des Elements, das abgerufen oder festgelegt werden soll.
Eigenschaftswert
Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden wird, wird versucht, ihn ArgumentExceptionabzurufen, ein neues Element mit dem angegebenen Schlüssel zu erstellen.
Durch Das Übergeben einer Nulltaste (Nothing in Visual Basic) wird ein ArgumentNullException ausgelöst. Durch das Zuweisen eines NULL-Werts wird das Schlüssel-Wert-Paar entfernt.
- Attribute
Ausnahmen
Der Wert für keyword den Wert wurde in der Auflistung nicht festgelegt.
keyword ist ein Nullverweis (Nothing in Visual Basic).
Die Eigenschaft wird festgelegt, und die DbConnectionStringBuilder Eigenschaft ist schreibgeschützt.
-oder-
Die Eigenschaft ist festgelegt, keyword ist in der Auflistung nicht vorhanden und hat DbConnectionStringBuilder eine feste Größe.
Beispiele
Die folgende Konsolenanwendung erstellt eine neue DbConnectionStringBuilder und fügt der Verbindungszeichenfolge Schlüssel-Wert-Paare hinzu, wobei die Eigenschaft Item[] verwendet wird.
static void Main()
{
DbConnectionStringBuilder builder = new
DbConnectionStringBuilder();
builder["Data Source"] = "(local)";
// Note that Item is the indexer, so
// you do not include it in the reference.
builder["integrated security"] = true;
builder["Initial Catalog"] = "AdventureWorks";
// Overwrite the existing value for the Data Source key,
// because it already exists within the collection.
builder["Data Source"] = ".";
Console.WriteLine(builder.ConnectionString);
Console.WriteLine();
Console.WriteLine("Press Enter to continue.");
Console.ReadLine();
}
Module Module1
Sub Main()
Dim builder As New DbConnectionStringBuilder
builder.Item("Data Source") = "(local)"
' Item is the default property, so
' you need not include it in the reference.
builder("integrated security") = True
builder.Item("Initial Catalog") = "AdventureWorks"
' Overwrite the existing value for the data source value,
' because it already exists within the collection.
builder.Item("Data Source") = "."
Console.WriteLine(builder.ConnectionString)
Console.WriteLine()
Console.WriteLine("Press Enter to continue.")
Console.ReadLine()
End Sub
Hinweise
Wenn Sie diese Eigenschaft festlegen, wird der Wert ersetzt, wenn der angegebene Schlüssel bereits im Wörterbuch vorhanden ist. andernfalls wird ein neues Element erstellt.
