Teilen über


NameValueCollection.Item[] Eigenschaft

Definition

Ruft den angegebenen Eintrag der NameValueCollection-Instanz ab oder legt diesen fest.

Überlädt

Item[Int32]

Ruft den Eintrag am angegebenen Index der NameValueCollection-Instanz ab.

Item[String]

Ruft den Eintrag mit dem angegebenen Schlüssel in der NameValueCollection-Instanz ab oder legt diesen fest.

Item[Int32]

Quelle:
NameValueCollection.cs
Quelle:
NameValueCollection.cs
Quelle:
NameValueCollection.cs

Ruft den Eintrag am angegebenen Index der NameValueCollection-Instanz ab.

public:
 property System::String ^ default[int] { System::String ^ get(int index); };
public string this[int index] { get; }
public string? this[int index] { get; }
member this.Item(int) : string
Default Public ReadOnly Property Item(index As Integer) As String

Parameter

index
Int32

Der nullbasierte Index des Eintrags, der in der Auflistung gesucht werden soll.

Eigenschaftswert

Ein String, der am angegebenen Index der Auflistung die Liste von durch Trennzeichen getrennten Werten enthält.

Ausnahmen

index liegt außerhalb des gültigen Bereichs von Indizes für die Auflistung.

Hinweise

Über diese Eigenschaft können Sie mithilfe der folgenden Syntax auf ein bestimmtes Element der Auflistung zugreifen: myCollection[index].

Diese Eigenschaft kann nicht festgelegt werden. Verwenden Sie Item[GetKey(index)], um den Wert auf einen angegebenen Index festzulegen.

Die Sprache C# verwendet die Schlüsselwort (keyword), um die Indexer zu definieren, anstatt die Item[] -Eigenschaft zu implementieren. Visual Basic implementiert Item[] als Standardeigenschaft, die die gleiche Indizierungsfunktionalität bereitstellt.

Das Abrufen der Werte am angegebenen Index ist ein O(n)-Vorgang, wobei n die Anzahl der Werte ist.

Weitere Informationen

Gilt für:

Item[String]

Quelle:
NameValueCollection.cs
Quelle:
NameValueCollection.cs
Quelle:
NameValueCollection.cs

Ruft den Eintrag mit dem angegebenen Schlüssel in der NameValueCollection-Instanz ab oder legt diesen fest.

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; }
public string? this[string? name] { get; set; }
member this.Item(string) : string with get, set
Default Public Property Item(name As String) As String

Parameter

name
String

Der String-Schlüssel des zu suchenden Eintrags. Der Schlüssel kann null sein.

Eigenschaftswert

Ein String, der die Liste mit durch Trennzeichen getrennten Werten enthält, die dem angegebenen Schlüssel zugeordnet sind, sofern dieser gefunden wurde; andernfalls null.

Ausnahmen

Die Auflistung ist schreibgeschützt, und der Vorgang versucht, die Auflistung zu ändern.

Hinweise

Über diese Eigenschaft können Sie mithilfe der folgenden Syntax auf ein bestimmtes Element der Auflistung zugreifen: 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 -Methode, um den neuen Wert an die Add vorhandene Liste von Werten anzufügen.

Wenn der angegebene Schlüssel nicht in der Auflistung vorhanden ist, erstellt das Festlegen dieser Eigenschaft einen neuen Eintrag mit dem angegebenen Schlüssel und dem angegebenen Wert.

Achtung

Diese Eigenschaft gibt in den folgenden Fällen zurück null : 1), wenn der angegebene Schlüssel nicht gefunden wird; und 2), wenn der angegebene Schlüssel gefunden wird und der zugehörige Wert ist null. Diese Eigenschaft unterscheidet nicht zwischen den beiden Fällen.

Die Sprache C# verwendet die Schlüsselwort (keyword), um die Indexer zu definieren, anstatt die Item[] -Eigenschaft zu implementieren. Visual Basic implementiert Item[] als Standardeigenschaft, die die gleiche Indizierungsfunktionalität 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 ist.

Weitere Informationen

Gilt für: