SortedList.Item[Object] Eigenschaft

Definition

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

Eigenschaftswert

Object

Wenn key gefunden wird, der dem SortedList-Parameter zugeordnete Wert im key-Objekt, andernfalls null.

Implementiert

Ausnahmen

key ist null.

Die Eigenschaft wird festgelegt, und das SortedList-Objekt ist schreibgeschützt.

- oder - Die Eigenschaft wird festgelegt, key ist in der Auflistung nicht vorhanden, und der SortedList hat eine feste Größe.

Es ist nicht genügend Arbeitsspeicher verfügbar, um das Element zu SortedList hinzuzufügen.

Der Vergleich löst eine Ausnahme aus.

Hinweise

Sie können die -Eigenschaft verwenden, um auf ein bestimmtes Element in einer Auflistung zu zugreifen, indem Item[] Sie die folgende Syntax angeben: myCollection[key] .

Sie können diese Eigenschaft auch verwenden, um neue Elemente hinzuzufügen, indem Sie den Wert eines Schlüssels festlegen, der nicht im -Objekt vorhanden ist SortedList (z. myCollection["myNonexistentKey"] = myValue) B. ). Wenn der angegebene Schlüssel jedoch bereits in vorhanden ist, überschreibt das Festlegen der -Eigenschaft SortedList Item[] den alten Wert. Im Gegensatz dazu ändert Add die -Methode keine vorhandenen Elemente.

Ein Schlüssel kann nicht null sein, aber ein Wert kann sein. Verwenden Sie die -Methode oder die -Methode, um zu bestimmen, ob der Schlüssel in der Liste vorhanden ist, um zu unterscheiden, ob zurückgegeben wird, weil der angegebene Schlüssel nicht gefunden wurde und der zurückgegeben wird, da der Wert des angegebenen Schlüssels null null null Contains ContainsKey ist.

Die Elemente eines werden nach den Schlüsseln sortiert, entweder nach einer bestimmten Implementierung, die beim Erstellen des angegeben wurde, oder nach der Implementierung, die von den SortedList IComparer SortedList IComparable Schlüsseln selbst bereitgestellt wird.

Die C#-Sprache verwendet das this Schlüsselwort , um die Indexer zu definieren, anstatt die -Eigenschaft zu Keys implementieren. Visual Basic implementiert Item[] als Standardeigenschaft und stellt auf diese Weise dieselbe Indizierungsfunktionalität bereit.

Das Abrufen des Werts dieser Eigenschaft ist ein O(log n) Vorgang, wobei n Count ist. Das Festlegen der -Eigenschaft ist O(log n) ein Vorgang, wenn sich der Schlüssel bereits im SortedList befindet. Wenn der Schlüssel nicht in der Liste enthalten ist, ist das Festlegen der Eigenschaft ein Vorgang für unsortierte Daten, oder wenn das neue Element am Ende der O(n) O(log n) Liste hinzugefügt wird. Wenn das Einfügen eine Größenvergrößerung verursacht, ist der Vorgang O(n) .

Gilt für

Siehe auch