Hashtable.Item-Eigenschaft

Ruft den Wert ab, der dem angegebenen Schlüssel zugeordnet ist, oder legt diesen fest.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Overridable Default Property Item ( _
    key As Object _
) As Object
'Usage
Dim instance As Hashtable
Dim key As Object
Dim value As Object

value = instance(key)

instance(key) = value

public virtual Object this [
    Object key
] { get; set; }

public:
virtual property Object^ default [Object^] {
    Object^ get (Object^ key);
    void set (Object^ key, Object^ value);
}

/** @property */
public Object get_Item (Object key)

/** @property */
public void set_Item (Object key, Object value)

JScript unterstützt die Verwendung von indizierten Eigenschaften, aber nicht die Deklaration von neuen indizierten Eigenschaften.

Parameter

• key
  Der Schlüssel, dessen Wert abgerufen oder festgelegt werden soll.

Eigenschaftenwert

Der dem angegebenen Schlüssel zugeordnete Wert. Wenn der angegebene Schlüssel nicht gefunden werden kann, wird beim Abrufen dieses Schlüssels NULL (Nothing in Visual Basic) zurückgegeben. Beim Festlegen wird ein neues Element mit dem angegebenen Schlüssel erstellt.

Ausnahmen

Ausnahmetyp	Bedingung
ArgumentNullException	key ist NULL (Nothing in Visual Basic).
NotSupportedException	Die Eigenschaft wird festgelegt, und die Hashtable ist schreibgeschützt. – oder – Die Eigenschaft wird festgelegt, key ist in der Auflistung nicht vorhanden, und die Hashtable hat eine feste Größe.

Hinweise

Diese Eigenschaft ermöglicht den Zugriff auf ein bestimmtes Element in der Auflistung mit folgender Syntax: myCollection[key].

Sie können die Item-Eigenschaft auch zum Hinzufügen neuer Elemente verwenden, indem Sie den Wert eines Schlüssels festlegen, der in der Hashtable nicht vorhanden ist, beispielsweise myCollection["myNonexistentKey"] = myValue. Wenn der angegebene Schlüssel jedoch bereits in der Hashtable vorhanden ist, wird der alte Wert durch Festlegen der Item-Eigenschaft überschrieben. Im Gegensatz dazu ändert die Add-Methode keine vorhandenen Elemente.

Ein Schlüssel kann nicht NULL (Nothing in Visual Basic) sein, bei einem Wert ist dies hingegen möglich. Um zu unterscheiden, ob NULL (Nothing in Visual Basic) zurückgegeben wird, weil der angegebene Schlüssel nicht gefunden wurde, oder ob NULL (Nothing in Visual Basic) zurückgegeben wird, weil der Wert des angegebenen Schlüssels NULL (Nothing in Visual Basic) ist, verwenden Sie die Contains-Methode oder die ContainsKey-Methode, und bestimmen Sie so, ob der Schlüssel in der Liste vorhanden ist.

Das Abrufen des Werts dieser Eigenschaft ist ebenso wie das Festlegen der Eigenschaft eine O(1)-Operation.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

Hashtable-Klasse
Hashtable-Member
System.Collections-Namespace
Add