Partager via


SortedList.Item[Object] Propriété

Définition

Obtient ou définit la valeur associée à une clé spécifique dans un objet SortedList.

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

Valeur associée au paramètre key dans l'objet SortedList, si key existe ; sinon, null.

Implémente

Exceptions

key a la valeur null.

La propriété est définie et l'objet SortedList est en lecture seule.

- ou -

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

La mémoire disponible est insuffisante pour ajouter l'élément à SortedList.

Le comparateur lève une exception.

Remarques

Vous pouvez utiliser la Item[] propriété pour accéder à un élément spécifique d’une collection en spécifiant la syntaxe suivante : myCollection[key].

Vous pouvez également utiliser cette propriété pour ajouter de nouveaux éléments en définissant la valeur d’une clé qui n’existe pas dans l’objet SortedList (par exemple, myCollection["myNonexistentKey"] = myValue). Toutefois, si la clé spécifiée existe déjà dans , la SortedListdé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.

Les éléments d’un SortedList sont triés par clés selon une implémentation spécifique IComparer spécifiée lors de la SortedList création ou selon l’implémentation IComparable fournie par les clés elles-mêmes.

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

La récupération de la valeur de cette propriété est une O(log n) opération, où n est Count. La définition de la propriété est une O(log n) opération si la clé se trouve déjà dans .SortedList Si la clé ne figure pas dans la liste, la définition de la propriété est une O(n) opération pour les données non triées ou O(log n) si le nouvel élément est ajouté à la fin de la liste. Si l’insertion provoque un redimensionnement, l’opération est O(n).

S’applique à

Voir aussi