Hashtable.Item[Object] Vlastnost

Definice

Obor názvů:

System.Collections

Sestavení:

System.Runtime.dll

Zdroj:

Hashtable.cs

Získá nebo nastaví hodnotu přidruženou k zadanému klíči.

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íč, jehož hodnotu chcete získat nebo nastavit.

Hodnota vlastnosti

Object

Hodnota přidružená k zadanému klíči. Pokud zadaný klíč není nalezen, při pokusu o jeho získání se vrátí nulla při pokusu o jeho nastavení se vytvoří nový prvek pomocí zadaného klíče.

Implementuje

Item[Object]

Výjimky

ArgumentNullException

key je null.

NotSupportedException

Vlastnost je nastavená a Hashtable je jen pro čtení.

-nebo-

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

Poznámky

Tato vlastnost poskytuje možnost přístupu ke konkrétnímu prvku v kolekci pomocí následující syntaxe: myCollection[key].

Vlastnost můžete také použít Item[] k přidání nových prvků nastavením hodnoty klíče, který v objektu Hashtableneexistuje, myCollection["myNonexistentKey"] = myValuenapříklad . Pokud však zadaný klíč již existuje v Hashtable, 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 který je vrácen, protože zadaný klíč nebyl nalezen a null který je vrácen, protože hodnota zadaného klíče je null, použijte metodu Contains nebo metodu ContainsKey určit, zda klíč existuje v seznamu.

Načtení hodnoty této vlastnosti je O(1) operace. Nastavení vlastnosti je také O(1) operace.

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

Viz také

• Add(Object, Object)