Hashtable.Item[Object] Propriété

Définition

Espace de noms:

System.Collections

Assembly:

System.Runtime.dll

Source:

Hashtable.cs

Obtient ou définit la valeur associée à la clé spécifiée.

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, set

Default Public Overridable Property Item(key As Object) As Object

Paramètres

key

Object

Clé dont la valeur doit être obtenue ou définie.

Valeur de propriété

Object

Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, la tentative d'obtention retourne null et la tentative de définition crée un nouvel élément avec la clé spécifiée.

Implémente

Item[Object]

Exceptions

ArgumentNullException

key a la valeur null.

NotSupportedException

La propriété est définie et Hashtable est en lecture seule.

- ou -

La propriété est définie, key n’existe pas dans la collection et Hashtable a une taille fixe.

Remarques

Cette propriété permet d'accéder à un élément spécifique dans la collection à l'aide de la syntaxe suivante : myCollection[key].

Vous pouvez également utiliser la Item[] propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans ; Hashtablepar exemple, myCollection["myNonexistentKey"] = myValue. Toutefois, si la clé spécifiée existe déjà dans , la Hashtabledéfinition de la Item[] propriété remplace l’ancienne valeur. En revanche, la Add méthode ne modifie pas les éléments existants.

Une clé ne peut pas être null, mais une valeur peut l’être. Pour faire la distinction entre null ce qui est retourné parce que la clé spécifiée est introuvable et null qui est retournée parce que la valeur de la clé spécifiée est null, utilisez la Contains méthode ou la ContainsKey méthode pour déterminer si la clé existe dans la liste.

La récupération de la valeur de cette propriété est une O(1) opération ; la définition de la propriété est également une O(1) opération.

Le langage C# utilise le mot clé this pour définir les indexeurs au lieu d'implémenter la propriété Item[]. Visual Basic implémente Item[] comme propriété par défaut, ce qui fournit les mêmes fonctionnalités d'indexation.

Voir aussi

• Add(Object, Object)