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.
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, 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 werden kann, wird beim Abrufen dieses Schlüssels null zurückgegeben. Beim Festlegen wird ein neues Element mit dem angegebenen Schlüssel erstellt.
Implementiert
Ausnahmen
key ist null.
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 in der HashtableEigenschaft 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. Um zwischen null dem zurückgegebenen Wert zu unterscheiden, da der angegebene Schlüssel nicht gefunden wird und null zurückgegeben wird, da der Wert des angegebenen Schlüssels lautet null, verwenden Sie die Contains Methode oder die ContainsKey Methode, um festzustellen, ob der Schlüssel in der Liste vorhanden ist.
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 implementiert Item[] als Standardeigenschaft und stellt auf diese Weise dieselbe Indizierungsfunktionalität bereit.