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]

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

String

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. Um den Wert auf 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 als Standardeigenschaft, die dieselbe Indizierungsfunktion Item[] bereitstellt.

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

Siehe auch

Gilt für

Item[String]

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

String

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. Um den neuen Wert an die vorhandene Liste von Werten anzufügen, verwenden Sie die Add Methode.

Wenn der angegebene Schlüssel nicht in der Auflistung vorhanden ist, erstellt das Festlegen dieser Eigenschaft einen neuen Eintrag mithilfe des angegebenen Schlüssels und des angegebenen Werts.

Achtung

Diese Eigenschaft gibt null in den folgenden Fällen zurück: 1) wenn der angegebene Schlüssel nicht gefunden wird; und 2) wenn der angegebene Schlüssel gefunden wird und der zugeordnete Wert ist 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 als Standardeigenschaft, die dieselbe Indizierungsfunktion Item[] 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 liegt.

Siehe auch

Gilt für