SortedList.Item[Object] SortedList.Item[Object] SortedList.Item[Object] SortedList.Item[Object] Property

Définition

Obtient ou définit la valeur associée à une clé spécifique dans un objet SortedList.Gets or sets the value associated with a specific key in a SortedList object.

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 Object Object Object

Clé dont la valeur doit être obtenue ou définie.The key associated with the value to get or set.

Valeur de propriété

Valeur associée au paramètre key dans l'objet SortedList, si key existe ; sinon, null.The value associated with the key parameter in the SortedList object, if key is found; otherwise, null.

Implémente

Exceptions

La propriété est définie et l'objet SortedList est en lecture seule.The property is set and the SortedList object is read-only.

- ou --or- La propriété est définie, key n’existe pas dans la collection et SortedList a une taille fixe.The property is set, key does not exist in the collection, and the SortedList has a fixed size.

La mémoire disponible est insuffisante pour ajouter l'élément à SortedList.There is not enough available memory to add the element to the SortedList.

Le comparateur lève une exception.The comparer throws an exception.

Remarques

Vous pouvez utiliser la Item[Object] propriété pour accéder à un élément spécifique dans une collection en spécifiant la syntaxe myCollection[key]suivante:.You can use the Item[Object] property to access a specific element in a collection by specifying the following syntax: 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 SortedList dans l’objet (par myCollection["myNonexistentKey"] = myValue)exemple,.You can also use this property to add new elements by setting the value of a key that does not exist in the SortedList object (for example, myCollection["myNonexistentKey"] = myValue). Toutefois, si la clé spécifiée existe déjà dans le SortedList, la définition Item[Object] de la propriété remplace l’ancienne valeur.However, if the specified key already exists in the SortedList, setting the Item[Object] property overwrites the old value. En revanche, la Add méthode ne modifie pas les éléments existants.In contrast, the Add method does not modify existing elements.

Une clé ne peut nullpas être, mais une valeur peut être.A key cannot be null, but a value can be. Pour null distinguer la valeur retournée parce que la clé spécifiée est introuvable et null qu’elle est retournée parce que la valeur nullde la clé Contains spécifiée est, ContainsKey utilisez la méthode ou la méthode pour déterminer si la clé existe dans la liste.To distinguish between null that is returned because the specified key is not found and null that is returned because the value of the specified key is null, use the Contains method or the ContainsKey method to determine if the key exists in the list.

Les éléments d’un SortedList sont triés par les clés selon une implémentation spécifique IComparer spécifiée lorsque le SortedList est créé ou en fonction de l' IComparable implémentation fournie par les clés elles-mêmes.The elements of a SortedList are sorted by the keys either according to a specific IComparer implementation specified when the SortedList is created or according to the IComparable implementation provided by the keys themselves.

Le C# langage utilise le this mot clé pour définir les indexeurs au lieu d' Keys implémenter la propriété.The C# language uses the this keyword to define the indexers instead of implementing the Keys property. Visual Basic implémente Item[Object] comme propriété par défaut, ce qui fournit les mêmes fonctionnalités d'indexation.Visual Basic implements Item[Object] as a default property, which provides the same indexing functionality.

La récupération de la valeur de cette propriété est une opération O n(log), nCountest.Retrieving the value of this property is an O(log n) operation, where n is Count. La définition de la propriété est une opération nO (log) si la clé est déjà SortedListdans le.Setting the property is an O(log n) operation if the key is already in the SortedList. Si la clé ne figure pas dans la liste, la définition de la propriété estnune opération o () pour les données non triées, nou o (log) si le nouvel élément est ajouté à la fin de la liste.If the key is not in the list, setting the property is an O(n) operation for unsorted data, or O(log n) if the new element is added at the end of the list. Si l’insertion entraîne un redimensionnement, l’opération estnO ().If insertion causes a resize, the operation is O(n).

S’applique à

Voir aussi