Hashtable.Item[Object] Eigenschaft

Definition

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

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.

Gilt für:

Weitere Informationen