Hashtable.Item[Object] Egenskap
Definition
Viktigt
En del information gäller för förhandsversionen av en produkt och kan komma att ändras avsevärt innan produkten blir allmänt tillgänglig. Microsoft lämnar inga garantier, uttryckliga eller underförstådda, avseende informationen som visas här.
Hämtar eller anger värdet som är associerat med den angivna nyckeln.
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, setDefault Public Overridable Property Item(key As Object) As ObjectParametrar
- key
- Object
Nyckeln vars värde ska hämtas eller anges.
Egenskapsvärde
Värdet som är associerat med den angivna nyckeln. Om den angivna nyckeln inte hittas returnerar nullförsök att hämta den och försöker ange det ett nytt element med den angivna nyckeln.
Implementeringar
Undantag
key är null.
Egenskapen har angetts och Hashtable är skrivskyddad.
-eller-
Egenskapen har angetts, key finns inte i samlingen och Hashtable har en fast storlek.
Kommentarer
Den här egenskapen ger möjlighet att komma åt ett specifikt element i samlingen med hjälp av följande syntax: myCollection[key].
Du kan också använda Item[] egenskapen för att lägga till nya element genom att ange värdet för en nyckel som inte finns i Hashtable, till exempel myCollection["myNonexistentKey"] = myValue. Men om den angivna nyckeln redan finns i Hashtable, skriver egenskapen Item[] över det gamla värdet. Metoden ändrar däremot Add inte befintliga element.
En nyckel kan inte vara null, men ett värde kan vara. Om du vill skilja mellan null det returneras eftersom den angivna nyckeln inte hittas och null som returneras eftersom värdet för den angivna nyckeln är nullanvänder du Contains metoden eller ContainsKey metoden för att avgöra om nyckeln finns i listan.
Att hämta värdet för den här egenskapen är en O(1) åtgärd. Att ange egenskapen är också en O(1) åtgärd.
C#-språket använder nyckelordet this för att definiera indexerarna i stället för att Item[] implementera egenskapen. Visual Basic implementerar Item[] som en standardegenskap, vilket ger samma indexeringsfunktioner.