SortedList.Item[Object] Vlastnost

  • Reference

Definice

Obor názvů:
System.Collections
Sestavení:
mscorlib.dll, System.Collections.NonGeneric.dll
Sestavení:
System.Collections.NonGeneric.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
SortedList.cs
Zdroj:
SortedList.cs
Zdroj:
SortedList.cs

Získá nebo nastaví hodnotu přidruženou ke konkrétnímu klíči v objektu SortedList .

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

Parametry

key
Object

Klíč přidružený k hodnotě, kterou chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota přidružená k parametru key v objektu SortedList , pokud key je nalezena null; v opačném případě hodnota .

Implementuje

Item[Object]

Výjimky

ArgumentNullException

key je null.

NotSupportedException

Vlastnost je nastavena SortedList a objekt je jen pro čtení.

-nebo-

Vlastnost je nastavená, key v kolekci neexistuje a SortedList má pevnou velikost.

OutOfMemoryException

Pro přidání elementu do SortedListnení k dispozici dostatek paměti.

InvalidOperationException

Porovnávací nástroj vyvolá výjimku.

Poznámky

Vlastnost můžete použít Item[] pro přístup ke konkrétnímu prvku v kolekci zadáním následující syntaxe: myCollection[key].

Tuto vlastnost můžete použít také k přidání nových prvků nastavením hodnoty klíče, který v objektu SortedList neexistuje (například myCollection["myNonexistentKey"] = myValue)). Pokud však zadaný klíč již existuje v SortedList, nastavení Item[] vlastnosti přepíše starou hodnotu. Naproti tomu Add metoda neupravuje existující prvky.

Klíč nemůže být null, ale hodnota může být. Chcete-li rozlišovat mezi null vrácenou hodnotou, protože zadaný klíč nebyl nalezen a null který je vrácen, protože hodnota zadaného klíče je null, použijte Contains metodu nebo metodu ContainsKey k určení, zda klíč existuje v seznamu.

Prvky objektu SortedList jsou seřazeny podle klíčů buď podle konkrétní IComparer implementace zadané při SortedList vytvoření, nebo podle IComparable implementace poskytované samotnými klíči.

Jazyk C# používá this klíčové slovo k definování indexerů místo implementace Keys vlastnosti . Visual Basic implementuje Item[] jako výchozí vlastnost, která poskytuje stejné funkce indexování.

Načtení hodnoty této vlastnosti je O(log n) operace, kde n je Count. Nastavení vlastnosti je operace, O(log n) pokud je klíč již v objektu SortedList. Pokud klíč není v seznamu, nastavení vlastnosti je O(n) operace pro neseřazená data, nebo O(log n) pokud je nový prvek přidán na konec seznamu. Pokud vložení způsobí změnu velikosti, operace je O(n).

Platí pro

Viz také