Hashtable.Item[Object] Vlastnost

  • Reference

Definice

Obor názvů:
System.Collections
Sestavení:
mscorlib.dll, System.Collections.NonGeneric.dll
Sestavení:
System.Runtime.dll
Sestavení:
System.Collections.NonGeneric.dll
Sestavení:
System.Runtime.Extensions.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
Hashtable.cs
Zdroj:
Hashtable.cs
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; }
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 se zadaný klíč nenajde, 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š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.

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 implementuje Item[] jako výchozí vlastnost, která poskytuje stejné funkce indexování.

Platí pro

Viz také