SortedList.Item-Eigenschaft

Ruft den Wert ab, der einem bestimmten Schlüssel in SortedList zugeordnet ist, und 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 SortedList
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, der dem abzurufenden oder festzulegenden Wert zugeordnet ist.

Eigenschaftenwert

Wenn key gefunden wird, der key zugeordnete Wert in SortedList, andernfalls NULL (Nothing in Visual Basic).

Ausnahmen

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 SortedList nicht vorhanden ist, beispielsweise myCollection["myNonexistentKey"] = myValue. Wenn der angegebene Schlüssel jedoch bereits in SortedList vorhanden ist, wird der alte Wert beim 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 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.

Die Elemente einer SortedList sind nach Schlüsseln sortiert: entweder entsprechend einer bestimmten, beim Erstellen der SortedList angegebenen IComparer-Implementierung, oder entsprechend der von den Schlüsseln selbst bereitgestellten IComparable-Implementierung.

Das Abrufen des Werts dieser Eigenschaft ist ein O(log n)-Vorgang, wobei n für den Count steht. Das Festlegen dieser Eigenschaft ist ein O (log n)-Vorgang, wenn sich der Schlüssel bereits in der SortedList befindet. Wenn sich der Schlüssel nicht in der Liste befindet, ist das Festlegen dieser Eigenschaft bei unsortierten Daten ein O(n)-Vorgang oder ein O(log n)-Vorgang, wenn das neue Element am Ende der Liste hinzugefügt wird. Wenn beim Einfügen die Größe geändert werden muss, handelt es sich um einen O (n)-Vorgang.

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

Siehe auch

Referenz

SortedList-Klasse
SortedList-Member
System.Collections-Namespace
Add
Contains
ContainsKey

Weitere Ressourcen

Durchführen kulturunabhängiger Zeichenfolgenoperationen in Auflistungen