SortedList.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 à une clé spécifique dans un SortedList objet.
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é associée à la valeur à obtenir ou définir.
Valeur de propriété
Valeur associée au key paramètre dans l’objet SortedList , si key elle est trouvée ; 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 a SortedList une taille fixe.
Il n’y a pas suffisamment de mémoire disponible pour ajouter l’élément à 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 dans 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 le SortedListfichier , 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.
Les éléments d’un SortedList sont triés par les 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 this mot clé pour définir les indexeurs au lieu d’implémenter la Keys propriété. Visual Basic implémente Item[] en tant que propriété par défaut, 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é est déjà dans le SortedList. Si la clé n’est 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).
