SortedList.Item[Object] Eigenschaft

Referenz

Definition

Namespace:: System.Collections

Assemblys:: mscorlib.dll, System.Collections.NonGeneric.dll

Assembly:: System.Collections.NonGeneric.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: SortedList.cs

Quelle:: SortedList.cs

Quelle:: SortedList.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

Item[Object]

Ausnahmen

ArgumentNullException

key ist null.

NotSupportedException

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.

OutOfMemoryException

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

InvalidOperationException

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 SortedList Item[] -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: