Teilen über


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

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 Item[] -Eigenschaft verwenden, um auf ein bestimmtes Element in einer Auflistung zuzugreifen, indem 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, myCollection["myNonexistentKey"] = myValue)der SortedList im -Objekt nicht vorhanden ist (z. B. . Wenn der angegebene Schlüssel jedoch bereits in vorhanden ist, überschreibt die SortedListItem[] -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.

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

Die Programmiersprache C# verwendet für die Definition der Indexer das this-Schlüsselwort, anstatt die Keys-Eigenschaft zu 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 Das Festlegen der -Eigenschaft ist ein O(log n) Vorgang, wenn sich der Schlüssel bereits im SortedListbefindet. Wenn der Schlüssel nicht in der Liste enthalten ist, ist das Festlegen der Eigenschaft ein O(n) Vorgang für unsortierte Daten oder O(log n) wenn das neue Element am Ende der Liste hinzugefügt wird. Wenn das Einfügen eine Größenänderung bewirkt, lautet O(n)der Vorgang .

Gilt für:

Weitere Informationen