SortedList.Item[Object] Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

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 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).

Viz také

• Add(Object, Object)
• Contains(Object)
• ContainsKey(Object)
• Provádění řetězcových operací nezávislých na jazykové verzi v kolekcích