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; }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 obtenue 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 retourne null et la tentative de définition crée un nouvel élément avec la clé spécifiée.
Implémente
Exceptions
key a la valeur null.
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.
