Hashtable.Item[Object] Hashtable.Item[Object] Hashtable.Item[Object] Hashtable.Item[Object] Property

Definition

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.Gets or sets the value associated with the specified key.

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; }
member this.Item(obj) : obj with get, set
Default Public Overridable Property Item(key As Object) As Object

Parameter

key
Object Object Object Object

Der Schlüssel, dessen Wert abgerufen oder festgelegt werden soll.The key whose value to get or set.

Eigenschaftswert

Der dem angegebenen Schlüssel zugeordnete Wert.The value associated with the specified key. 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.If the specified key is not found, attempting to get it returns null, and attempting to set it creates a new element using the specified key.

Implementiert

Ausnahmen

Die Eigenschaft wird festgelegt, und Hashtable ist schreibgeschützt.The property is set and the Hashtable is read-only.

- oder --or- Die Eigenschaft wird festgelegt, key ist in der Auflistung nicht vorhanden, und Hashtable hat eine feste Größe.The property is set, key does not exist in the collection, and the Hashtable has a fixed size.

Hinweise

Diese Eigenschaft ermöglicht den Zugriff auf ein bestimmtes Element in der Auflistung mithilfe folgender Syntax: myCollection[key].This property provides the ability to access a specific element in the collection by using the following syntax: myCollection[key].

Sie können auch die Item[Object] zum Hinzufügen neuer Elemente durch Festlegen des Werts eines Schlüssels, die Eigenschaft ist nicht vorhanden, der Hashtable, z. B. myCollection["myNonexistentKey"] = myValueYou can also use the Item[Object] property to add new elements by setting the value of a key that does not exist in the Hashtable; for example, myCollection["myNonexistentKey"] = myValue. Wenn der angegebene Schlüssel jedoch bereits im Hashtable vorhanden ist, überschreibt das Festlegen der Eigenschaft Item[Object] den alten Wert.However, if the specified key already exists in the Hashtable, setting the Item[Object] property overwrites the old value. Im Gegensatz dazu ändert die Methode Add vorhandene Elemente nicht.In contrast, the Add method does not modify existing elements.

Ein Schlüssel kann nicht null sein, aber ein Wert kann sein.A key cannot be null, but a value can be. Um zu unterscheiden, ob null zurückgegeben wird, weil der angegebene Schlüssel nicht gefunden wurde, und null zurückgegeben wird, da der Wert des angegebenen Schlüssels null ist, verwenden Sie die Contains-Methode oder die ContainsKey-Methode, um zu bestimmen, ob der Schlüssel in der Liste vorhanden ist.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Das Abrufen des Werts dieser Eigenschaft ist ein O(1)-Vorgang. das Festlegen der-Eigenschaft ist ebenfalls ein O(1)-Vorgang.Retrieving the value of this property is an O(1) operation; setting the property is also an O(1) operation.

Die C# Sprache verwendet das this- Schlüsselwort, um die Indexer zu definieren, anstatt die Item[Int32]-Eigenschaft zu implementieren.The C# language uses the this keyword to define the indexers instead of implementing the Item[Int32] property. Visual Basic implementiert Item[Object] als Standardeigenschaft und stellt auf diese Weise dieselbe Indizierungsfunktionalität bereit.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

Gilt für:

Siehe auch