Hashtable.Item[Object] Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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, setDefault Public Overridable Property Item(key As Object) As ObjectParamètres
- key
- Object
Clé dont la valeur doit être get ou définie.
Valeur de propriété
Valeur associée à la clé spécifiée. Si la clé spécifiée est introuvable, la tentative d’obtention de la clé est retournée nullet la tentative de définition d’un élément à l’aide de la clé spécifiée.
Implémente
Exceptions
key a la valeur null.
La propriété est définie et la Hashtable propriété est en lecture seule.
-ou-
La propriété est définie, key n’existe pas dans la collection et a Hashtable 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 le Hashtable; par exemple. myCollection["myNonexistentKey"] = myValue Toutefois, si la clé spécifiée existe déjà dans le Hashtablefichier , la dé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 être. Pour faire la distinction entre null celle-ci, car la clé spécifiée est introuvable et null retournée, car 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 this mot clé pour définir les indexeurs au lieu d’implémenter la Item[] propriété. Visual Basic implémente Item[] en tant que propriété par défaut, qui fournit les mêmes fonctionnalités d’indexation.