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 vorhanden ist, überschreibt die HashtableItem[] -Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode vorhandene Elemente nicht.
Ein Schlüssel kann nicht sein null, aber ein Wert kann sein. Um zu null unterscheiden, dass zurückgegeben wird, weil 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 auch 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.
