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 spróbuj ustawić, aby utworzyć nowy element przy użyciu określonego klucza.
Implementuje
Wyjątki
Parametr key ma wartość null.
Właściwość jest ustawiona Hashtable , a właściwość 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 Hashtableobiekcie , 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ść.
Add Natomiast metoda nie modyfikuje istniejących elementów.
Kluczem nie może być null, ale może 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 zdefiniowania 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.
