Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

SortedList classe

 

Date de publication : novembre 2016

Représente une collection de paires clé/valeur triées par les clés et accessible par clé et par index.

Espace de noms:   System.Collections
Assembly:  mscorlib (dans mscorlib.dll)

System.Object
  System.Collections.SortedList

[SerializableAttribute]
[ComVisibleAttribute(true)]
public class SortedList : IDictionary, ICollection, IEnumerable, 
	ICloneable

NomDescription
System_CAPS_pubmethodSortedList()

Initialise une nouvelle instance de la SortedList classe qui est vide, possède la capacité initiale par défaut et est triée suivant le IComparable interface implémentée par chaque clé ajoutée à le SortedList objet.

System_CAPS_pubmethodSortedList(IComparer)

Initialise une nouvelle instance de la SortedList classe qui est vide, possède la capacité initiale par défaut et est triée en fonction de l’élément spécifié IComparer interface.

System_CAPS_pubmethodSortedList(IComparer, Int32)

Initialise une nouvelle instance de la SortedList classe qui est vide, possède la capacité initiale spécifiée et est triée en fonction de l’élément spécifié IComparer interface.

System_CAPS_pubmethodSortedList(IDictionary)

Initialise une nouvelle instance de la SortedList classe qui contient des éléments copiés à partir du dictionnaire spécifié, possède la capacité initiale que le nombre d’éléments copiés et est triée suivant le IComparable interface implémentée par chaque clé.

System_CAPS_pubmethodSortedList(IDictionary, IComparer)

Initialise une nouvelle instance de la SortedList classe qui contient des éléments copiés à partir du dictionnaire spécifié, possède la capacité initiale que le nombre d’éléments copiés et est triée en fonction de l’élément spécifié IComparer interface.

System_CAPS_pubmethodSortedList(Int32)

Initialise une nouvelle instance de la SortedList classe qui est vide, possède la capacité initiale spécifiée et est triée suivant le IComparable interface implémentée par chaque clé ajoutée à le SortedList objet.

NomDescription
System_CAPS_pubpropertyCapacity

Obtient ou définit la capacité d’un SortedList objet.

System_CAPS_pubpropertyCount

Obtient le nombre d’éléments contenus dans un SortedList objet.

System_CAPS_pubpropertyIsFixedSize

Obtient une valeur indiquant si un SortedList objet a une taille fixe.

System_CAPS_pubpropertyIsReadOnly

Obtient une valeur indiquant si un SortedList objet est en lecture seule.

System_CAPS_pubpropertyIsSynchronized

Obtient une valeur indiquant si l’accès à un SortedList objet est synchronisé (thread-safe).

System_CAPS_pubpropertyItem[Object]

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

System_CAPS_pubpropertyKeys

Obtient les clés d’un SortedList objet.

System_CAPS_pubpropertySyncRoot

Obtient un objet qui peut être utilisé pour synchroniser l’accès à un SortedList objet.

System_CAPS_pubpropertyValues

Obtient les valeurs dans une SortedList objet.

NomDescription
System_CAPS_pubmethodAdd(Object, Object)

Ajoute un élément avec la clé spécifiée et la valeur pour un SortedList objet.

System_CAPS_pubmethodClear()

Supprime tous les éléments d'un objet SortedList.

System_CAPS_pubmethodClone()

Crée une copie superficielle d’un SortedList objet.

System_CAPS_pubmethodContains(Object)

Détermine si un SortedList objet contient une clé spécifique.

System_CAPS_pubmethodContainsKey(Object)

Détermine si un SortedList objet contient une clé spécifique.

System_CAPS_pubmethodContainsValue(Object)

Détermine si un SortedList objet contient une valeur spécifique.

System_CAPS_pubmethodCopyTo(Array, Int32)

Copies SortedList éléments unidimensionnel Array objet, en commençant à l’index spécifié du tableau.

System_CAPS_pubmethodEquals(Object)

Détermine si l'objet spécifié est identique à l'objet actuel.(Hérité de Object.)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetByIndex(Int32)

Obtient la valeur de l’index spécifié d’un SortedList objet.

System_CAPS_pubmethodGetEnumerator()

Retourne un IDictionaryEnumerator objet qui effectue une itération dans un SortedList objet.

System_CAPS_pubmethodGetHashCode()

Fait office de fonction de hachage par défaut.(Hérité de Object.)

System_CAPS_pubmethodGetKey(Int32)

Obtient la clé à l’index spécifié d’un SortedList objet.

System_CAPS_pubmethodGetKeyList()

Obtient les clés d’un SortedList objet.

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_pubmethodGetValueList()

Obtient les valeurs dans une SortedList objet.

System_CAPS_pubmethodIndexOfKey(Object)

Retourne l’index de base zéro de la clé spécifiée dans un SortedList objet.

System_CAPS_pubmethodIndexOfValue(Object)

Retourne l’index de base zéro de la première occurrence de la valeur spécifiée dans un SortedList objet.

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodRemove(Object)

Supprime l’élément avec la clé spécifiée dans un SortedList objet.

System_CAPS_pubmethodRemoveAt(Int32)

Supprime l’élément à l’index spécifié d’un SortedList objet.

System_CAPS_pubmethodSetByIndex(Int32, Object)

Remplace la valeur à un index spécifique dans un SortedList objet.

System_CAPS_pubmethodSystem_CAPS_staticSynchronized(SortedList)

Retourne un wrapper de synchronisé (thread-safe) pour un SortedList objet.

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente l'objet actuel.(Hérité de Object.)

System_CAPS_pubmethodTrimToSize()

Définit la capacité au nombre réel d’éléments dans un SortedList objet.

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIEnumerable.GetEnumerator()

Retourne un IEnumerator qui effectue une itération dans le SortedList.

NomDescription
System_CAPS_pubmethodAsParallel()

Surchargé. Active la parallélisation d'une requête.(Défini par ParallelEnumerable.)

System_CAPS_pubmethodAsQueryable()

Surchargé. Convertit un IEnumerable à un IQueryable.(Défini par Queryable.)

System_CAPS_pubmethodCast<TResult>()

Convertit les éléments d’un IEnumerable au type spécifié.(Défini par Enumerable.)

System_CAPS_pubmethodOfType<TResult>()

Filtre les éléments d’un IEnumerable basé sur un type spécifié.(Défini par Enumerable.)

Pour la version générique de cette collection, consultez la page System.Collections.Generic.SortedList<TKey, TValue>.

Un SortedList est accessible par sa clé, comme un élément dans un élément IDictionary implémentation, ou par son index, comme un élément d’une IList mise en œuvre.

Un SortedList objet maintient en interne deux tableaux pour stocker les éléments de la liste, c'est-à-dire un tableau pour les clés et un autre pour les valeurs associées. Chaque élément est une paire clé/valeur qui sont accessibles en tant qu’un DictionaryEntry objet. Une clé ne peut pas être null, mais une valeur peut être.

La capacité d’un SortedList objet est le nombre d’éléments du SortedList peut contenir. Lorsque des éléments sont ajoutés à un SortedList, la capacité augmente automatiquement par réallocation. La capacité peut être diminuée en appelant TrimToSize ou en définissant le Capacity propriété explicitement.

De très grande SortedList des objets, vous pouvez augmenter la capacité maximale de 2 milliards des éléments sur un système 64 bits en définissant le enabled attribut de l’élément de configuration true dans l’environnement d’exécution.

Les éléments d’un SortedList objet sont triées par les clés soit en fonction de son propre IComparer implémentation spécifié lorsque le SortedList est créé ou suivant le IComparable implémentation fournie par les clés elles-mêmes. Dans les deux cas, un SortedList n’autorise pas les clés en double.

La séquence d’index est basée sur la séquence de tri. Lorsqu’un élément est ajouté, il est inséré dans SortedList dans le tri correct ordre et l’indexation s’ajuste en conséquence. Lorsqu’un élément est supprimé, l’indexation s’ajuste aussi en conséquence. Par conséquent, l’index d’une paire clé/valeur spécifique peut changer que les éléments sont ajoutés ou supprimés de la SortedList objet.

Opérations sur un SortedList objet ont tendance à être plus lentes que les opérations sur un Hashtable objet en raison du tri. Toutefois, le SortedList offre davantage de souplesse en autorisant l’accès aux valeurs via des clés associées ou les index.

Éléments de cette collection est accessible à l’aide d’un index d’entiers. Index de cette collection sont de base zéro.

La foreach instruction du langage c# (for each en Visual Basic) retourne un objet du type des éléments dans la collection. Étant donné que chaque élément de la SortedList objet est une paire clé/valeur, le type d’élément n’est pas le type de la clé ou le type de la valeur. Au lieu de cela, le type d’élément est DictionaryEntry. Exemple :

foreach (DictionaryEntry de in mySortedList)
{
    //...
}

La foreach instruction est un wrapper autour de l’énumérateur, qui permet la lecture de l’écriture ne pas dans la collection.

L’exemple de code suivant montre comment créer et initialiser un SortedList objet et l’impression de ses clés et valeurs.

using System;
using System.Collections;
public class SamplesSortedList  {

   public static void Main()  {

      // Creates and initializes a new SortedList.
      SortedList mySL = new SortedList();
       mySL.Add("Third", "!");
       mySL.Add("Second", "World");
       mySL.Add("First", "Hello");

      // Displays the properties and values of the SortedList.
      Console.WriteLine( "mySL" );
      Console.WriteLine( "  Count:    {0}", mySL.Count );
      Console.WriteLine( "  Capacity: {0}", mySL.Capacity );
      Console.WriteLine( "  Keys and Values:" );
      PrintKeysAndValues( mySL );
   }


   public static void PrintKeysAndValues( SortedList myList )  {
      Console.WriteLine( "\t-KEY-\t-VALUE-" );
      for ( int i = 0; i < myList.Count; i++ )  {
         Console.WriteLine( "\t{0}:\t{1}", myList.GetKey(i), myList.GetByIndex(i) );
      }
      Console.WriteLine();
   }
}
/*
This code produces the following output.

mySL
  Count:    3
  Capacity: 16
  Keys and Values:
    -KEY-    -VALUE-
    First:    Hello
    Second:    World
    Third:    !
*/

Plateforme Windows universelle
Disponible depuis 10
.NET Framework
Disponible depuis 1.1

Public static (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Un SortedList objet peut prendre en charge simultanément, plusieurs lecteurs tant que la collection n’est pas modifiée. Pour garantir la sécurité des threads de le SortedList, toutes les opérations doivent être effectuées via le wrapper retourné par la Synchronized méthode.

L'énumération d'une collection n'est intrinsèquement pas une procédure thread-safe. Même lorsqu'une collection est synchronisée, les autres threads peuvent toujours la modifier, ce qui entraîne la levée d'une exception par l'énumérateur. Pour garantir la sécurité des threads au cours de l'énumération, vous pouvez verrouiller la collection pendant l'ensemble de l'énumération ou bien intercepter les exceptions résultant des modifications apportées par les autres threads.

Retour au début
Afficher: