Hashtable.Item[Object] Właściwość

  • Odwołanie

Definicja

Przestrzeń nazw:
System.Collections
Zestawy:
mscorlib.dll, System.Collections.NonGeneric.dll
Zestaw:
System.Runtime.dll
Zestaw:
System.Collections.NonGeneric.dll
Zestaw:
System.Runtime.Extensions.dll
Zestaw:
mscorlib.dll
Zestaw:
netstandard.dll
Źródło:
Hashtable.cs
Źródło:
Hashtable.cs
Źródło:
Hashtable.cs

Pobiera lub ustawia wartość skojarzona z określonym kluczem.

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

Klucz, którego wartość ma być pobierana lub ustawiana.

Wartość właściwości

Object

Wartość skojarzona z określonym kluczem. Jeśli określony klucz nie zostanie znaleziony, próba pobrania go zwróci nullwartość i próba ustawienia tworzy nowy element przy użyciu określonego klucza.

Implementuje

Item[Object]

Wyjątki

ArgumentNullException

key to null.

NotSupportedException

Właściwość jest ustawiona, a właściwość Hashtable jest tylko do odczytu.

-lub-

Właściwość jest ustawiona, key nie istnieje w kolekcji i Hashtable ma stały rozmiar.

Uwagi

Ta właściwość umożliwia dostęp do określonego elementu w kolekcji przy użyciu następującej składni: myCollection[key].

Możesz również użyć Item[] właściwości , aby dodać nowe elementy, ustawiając wartość klucza, który nie istnieje w elemecie Hashtable, na przykład myCollection["myNonexistentKey"] = myValue. Jeśli jednak określony klucz już istnieje w Hashtableobiekcie , ustawienie Item[] właściwości zastępuje starą wartość. Z kolei Add metoda nie modyfikuje istniejących elementów.

Klucz nie może być nullwartością , ale może to być wartość. Aby odróżnić null ten element, ponieważ nie można odnaleźć określonego klucza i null jest zwracany, ponieważ wartość określonego klucza to null, użyj Contains metody lub ContainsKey metody , aby określić, czy klucz istnieje na liście.

Pobieranie wartości tej właściwości jest operacją O(1) ; ustawienie właściwości jest również operacją O(1) .

Język C# używa słowa kluczowego this do definiowania indeksatorów zamiast implementowania Item[] właściwości . Język Visual Basic implementuje Item[] jako właściwość domyślną, która zapewnia tę samą funkcję indeksowania.

Dotyczy

Zobacz też