Hashtable.Item[Object] 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::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, setDefault Public Overridable Property Item(key As Object) As ObjectParameter
- key
- Object
Der Schlüssel, dessen Wert abgerufen oder festgelegt werden soll.
Eigenschaftswert
Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden wird, wird versucht, ihn zurückzuholen null, und der Versuch, ihn festzulegen, ein neues Element mithilfe des angegebenen Schlüssels erstellt.
Implementiert
Ausnahmen
key ist null.
Die Eigenschaft wird festgelegt, und die Hashtable Eigenschaft ist schreibgeschützt.
-oder-
Die Eigenschaft ist festgelegt, key ist in der Auflistung nicht vorhanden und hat Hashtable eine feste Größe.
Hinweise
Diese Eigenschaft bietet die Möglichkeit, mithilfe der folgenden Syntax auf ein bestimmtes Element in der Auflistung zuzugreifen: myCollection[key]
Sie können die Item[] Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, Hashtableder myCollection["myNonexistentKey"] = myValuenicht im Schlüssel vorhanden ist, z. B. . . Wenn der angegebene Schlüssel jedoch bereits im HashtableBereich vorhanden 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 null die Methode oder die null Methode, um zu ermitteln, ob der Schlüssel in der Liste vorhanden istnull, um zwischen Contains dem zurückgegebenen Schlüssel zu unterscheiden, da der angegebene Schlüssel nicht gefunden wird und ContainsKey die zurückgegeben wird, da der Wert des angegebenen Schlüssels lautet.
Das Abrufen des Werts dieser Eigenschaft ist ein O(1) Vorgang. Das Festlegen der Eigenschaft ist auch ein O(1) Vorgang.
Die C#-Sprache verwendet das this Schlüsselwort, um die Indexer zu definieren, anstatt die Item[] Eigenschaft zu implementieren. Visual Basic wird als Standardeigenschaft implementiert Item[] , die die gleiche Indizierungsfunktion bereitstellt.
