Hashtable.Item[Object] Eigenschaft

  • Referenz

Definition

Namespace:
System.Collections
Assemblys:
mscorlib.dll, System.Collections.NonGeneric.dll
Assembly:
System.Runtime.dll
Assembly:
System.Collections.NonGeneric.dll
Assembly:
System.Runtime.Extensions.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Quelle:
Hashtable.cs
Quelle:
Hashtable.cs
Quelle:
Hashtable.cs

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.

public:
 virtual property System::Object ^ default[System::Object ^] { System::Object ^ get(System::Object ^ key); void set(System::Object ^ key, System::Object ^ value); };
public virtual object this[object key] { get; set; }
public virtual object? this[object key] { get; set; }
member this.Item(obj) : obj with get, set
Default Public Overridable Property Item(key As Object) As Object

Parameter

key
Object

Der Schlüssel, dessen Wert abgerufen oder festgelegt werden soll.

Eigenschaftswert

Object

Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden werden kann, wird beim Abrufen dieses Schlüssels null zurückgegeben. Beim Festlegen wird ein neues Element mit dem angegebenen Schlüssel erstellt.

Implementiert

Item[Object]

Ausnahmen

ArgumentNullException

key ist null.

NotSupportedException

Die Eigenschaft wird festgelegt, und Hashtable ist schreibgeschützt.

- oder -

Die Eigenschaft wird festgelegt, key ist in der Auflistung nicht vorhanden, und der Hashtable hat eine feste Größe.

Hinweise

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

Sie können auch die Item[] zum Hinzufügen neuer Elemente durch Festlegen des Werts eines Schlüssels, die Eigenschaft ist nicht vorhanden, der Hashtable, z. B. myCollection["myNonexistentKey"] = myValue Wenn der angegebene Schlüssel jedoch bereits im Hashtablevorhanden ist, überschreibt das Festlegen der Item[] -Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add -Methode keine vorhandenen Elemente.

Ein Schlüssel kann nicht sein null, aber ein Wert kann sein. Verwenden Sie die -Methode oder die -Methode, um zu unterscheidennull, ob der angegebene Schlüssel nicht gefunden und null zurückgegeben wird, weil der Wert des angegebenen Schlüssels ist. Verwenden Sie die Contains -Methode oder die ContainsKey -Methode, um zu bestimmen, ob der Schlüssel in der Liste vorhanden istnull.

Das Abrufen des Werts dieser Eigenschaft ist ein O(1) Vorgang. Das Festlegen der Eigenschaft ist ebenfalls ein O(1) Vorgang.

Die Programmiersprache C# verwendet für die Definition der Indexer das this-Schlüsselwort, anstatt die Item[]-Eigenschaft zu implementieren. Visual Basic implementiert Item[] als Standardeigenschaft und stellt auf diese Weise dieselbe Indizierungsfunktionalität bereit.

Gilt für:

Weitere Informationen