Hashtable.Item[Object] Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
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, setDefault Public Overridable Property Item(key As Object) As ObjectParametry
- key
- Object
Klucz, którego wartość ma być pobierana lub ustawiana.
Wartość właściwości
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
Wyjątki
key to null.
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.
