SortedList.Item[Object] Eigenschaft
Definition
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.
Dient zum Abrufen oder Festlegen des Werts, der einem bestimmten Schlüssel in einem SortedList Objekt zugeordnet ist.
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, setDefault Public Overridable Property Item(key As Object) As ObjectParameter
- key
- Object
Der dem Wert zugeordnete Schlüssel, der abgerufen oder festgelegt werden soll.
Eigenschaftswert
Der dem Parameter im SortedList Objekt zugeordnete key Wert, falls key gefunden; andernfalls . null
Implementiert
Ausnahmen
key ist null.
Die Eigenschaft wird festgelegt, und das SortedList Objekt ist schreibgeschützt.
- oder -
Die Eigenschaft ist festgelegt, key ist in der Auflistung nicht vorhanden und hat SortedList eine feste Größe.
Es steht nicht genügend Arbeitsspeicher zur Verfügung, um das Element dem SortedListElement 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, der SortedList im Objekt nicht vorhanden ist (z. B myCollection["myNonexistentKey"] = myValue). . Wenn der angegebene Schlüssel jedoch bereits im SortedListBereich vorhanden ist, überschreibt das Festlegen der Item[] Eigenschaft den alten Wert. Im Gegensatz dazu ändert die Add Methode keine vorhandenen Elemente.
Ein Schlüssel kann nicht sein null, aber ein Wert kann sein. Verwenden Sie Contains die Methode oder die ContainsKey Methode, um zu ermitteln, ob der Schlüssel in der Liste vorhanden istnull, um zwischen null dem zurückgegebenen Schlüssel zu unterscheiden, da der angegebene Schlüssel nicht gefunden wird und null die zurückgegeben wird, da der Wert des angegebenen Schlüssels lautet.
Die Elemente einer SortedList Werden nach den Schlüsseln sortiert, entweder nach einer bestimmten IComparer Implementierung, die beim SortedList Erstellen oder nach der IComparable implementierung angegeben wird, die von den Schlüsseln selbst bereitgestellt wird.
Die C#-Sprache verwendet das this Schlüsselwort, um die Indexer zu definieren, anstatt die Keys Eigenschaft zu implementieren. Visual Basic wird als Standardeigenschaft implementiert Item[] , die die gleiche Indizierungsfunktion bereitstellt.
Das Abrufen des Werts dieser Eigenschaft ist ein Vorgang. n Dabei handelt es sich um Counteinen O(log n) Vorgang. Das Festlegen der Eigenschaft ist ein O(log n) Vorgang, wenn der Schlüssel bereits in der SortedList. Wenn sich der Schlüssel nicht in der Liste befindet, ist das Festlegen der Eigenschaft ein O(n) Vorgang für nicht sortierte Daten oder O(log n) wenn das neue Element am Ende der Liste hinzugefügt wird. Wenn beim Einfügen eine Größenänderung verursacht wird, lautet O(n)der Vorgang .
