NameValueCollection.Item[] 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 angegebenen Eintrags der .NameValueCollection
Überlädt
| Name | Beschreibung |
|---|---|
| Item[Int32] |
Ruft den Eintrag am angegebenen Index der .NameValueCollection |
| Item[String] |
Dient zum Abrufen oder Festlegen des Eintrags mit dem angegebenen Schlüssel in der NameValueCollection. |
Item[Int32]
Ruft den Eintrag am angegebenen Index der .NameValueCollection
public:
property System::String ^ default[int] { System::String ^ get(int index); };public string this[int index] { get; }member this.Item(int) : stringDefault Public ReadOnly Property Item(index As Integer) As StringParameter
- index
- Int32
Der nullbasierte Index des Eintrags, der in der Auflistung gefunden werden soll.
Eigenschaftswert
Eine String , die die durch Trennzeichen getrennte Liste von Werten am angegebenen Index der Auflistung enthält.
Ausnahmen
index liegt außerhalb des gültigen Bereichs der Indizes für die Auflistung.
Hinweise
Diese Eigenschaft bietet die Möglichkeit, mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zuzugreifen: myCollection[index]
Diese Eigenschaft kann nicht festgelegt werden. Um den Wert bei einem angegebenen Index festzulegen, verwenden Sie Item[GetKey(index)].
Die C#-Sprache verwendet dieses Schlüsselwort, um die Indexer zu definieren, anstatt die Item[] Eigenschaft zu implementieren. Visual Basic implementiert Item[] als default-Eigenschaft, die die gleiche Indizierungsfunktion bereitstellt.
Das Abrufen der Werte am angegebenen Index ist ein O(n)-Vorgang, wobei n die Anzahl der Werte angegeben ist.
Weitere Informationen
Gilt für:
Item[String]
Dient zum Abrufen oder Festlegen des Eintrags mit dem angegebenen Schlüssel in der NameValueCollection.
public:
property System::String ^ default[System::String ^] { System::String ^ get(System::String ^ name); void set(System::String ^ name, System::String ^ value); };public string this[string name] { get; set; }member this.Item(string) : string with get, setDefault Public Property Item(name As String) As StringParameter
Eigenschaftswert
A String that contains the comma-separated list of values associated with the specified key, if found; otherwise, null.
Ausnahmen
Die Auflistung ist schreibgeschützt, und der Vorgang versucht, die Auflistung zu ändern.
Hinweise
Diese Eigenschaft bietet die Möglichkeit, mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zuzugreifen: myCollection[name]
Wenn der angegebene Schlüssel bereits in der Auflistung vorhanden ist, überschreibt das Festlegen dieser Eigenschaft die vorhandene Liste der Werte mit dem angegebenen Wert. Verwenden Sie die Add Methode, um den neuen Wert an die vorhandene Werteliste anzufügen.
Wenn der angegebene Schlüssel in der Auflistung nicht vorhanden ist, wird durch Festlegen dieser Eigenschaft ein neuer Eintrag mit dem angegebenen Schlüssel und dem angegebenen Wert erstellt.
Vorsicht
Diese Eigenschaft gibt in den folgenden Fällen zurück null : 1) wenn der angegebene Schlüssel nicht gefunden wird; and 2) if the specified key is found and its associated value is null. Diese Eigenschaft unterscheidet nicht zwischen den beiden Fällen.
Die C#-Sprache verwendet dieses Schlüsselwort, um die Indexer zu definieren, anstatt die Item[] Eigenschaft zu implementieren. Visual Basic implementiert Item[] als default-Eigenschaft, die die gleiche Indizierungsfunktion bereitstellt.
Das Abrufen oder Festlegen der Werte, die dem angegebenen Schlüssel zugeordnet sind, ist ein O(n)-Vorgang, wobei n die Anzahl der Werte angegeben ist.