SortedList.Item[Object] Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

netstandard.dll, System.Collections.NonGeneric.dll

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; }

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 v objektu keySortedList, pokud key je nalezena; v opačném případě . null

Implementuje

Item[Object]

Výjimky

ArgumentNullException

key je null.

NotSupportedException

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

nebo

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

OutOfMemoryException

Není k dispozici dostatek paměti pro přidání prvku do objektu SortedList.

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 také použít 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šit, null zda je vrácen, protože zadaný klíč nebyl nalezen a null 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 a 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 se 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 O(log n) operace, 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).

Viz také

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Provádění Culture-Insensitive řetězcových operací v kolekcích