Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

SortedList, classe

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

System.Object
  System.Collections.SortedList

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

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

Le type SortedList expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par XNA FrameworkSortedList()Initialise une nouvelle instance de la classe SortedList qui est vide, possède la capacité initiale par défaut et est triée suivant l'interface IComparable implémentée par chaque clé ajoutée à l'objet SortedList.
Méthode publiquePris en charge par XNA FrameworkSortedList(IComparer)Initialise une nouvelle instance de la classe SortedList qui est vide, possède la capacité initiale par défaut et est triée suivant l'interface IComparer spécifiée.
Méthode publiquePris en charge par XNA FrameworkSortedList(IDictionary)Initialise une nouvelle instance de la classe SortedList qui contient des éléments copiés à partir du dictionnaire spécifié, possède la capacité initiale correspondant au nombre d'éléments copiés et est triée suivant l'interface IComparable implémentée par chaque clé.
Méthode publiquePris en charge par XNA FrameworkSortedList(Int32)Initialise une nouvelle instance de la classe SortedList qui est vide, possède la capacité initiale spécifiée et est triée suivant l'interface IComparable implémentée par chaque clé ajoutée à l'objet SortedList.
Méthode publiquePris en charge par XNA FrameworkSortedList(IComparer, Int32)Initialise une nouvelle instance de la classe SortedList qui est vide, possède la capacité initiale spécifiée et est triée suivant l'interface IComparer spécifiée.
Méthode publiquePris en charge par XNA FrameworkSortedList(IDictionary, IComparer)Initialise une nouvelle instance de la classe SortedList qui contient des éléments copiés à partir du dictionnaire spécifié, possède la capacité initiale correspondant au nombre d'éléments copiés et est triée suivant l'interface IComparer spécifiée.
Début

  NomDescription
Propriété publiquePris en charge par XNA FrameworkCapacityObtient ou définit la capacité d'un objet SortedList.
Propriété publiquePris en charge par XNA FrameworkCountObtient le nombre d'éléments contenus dans un objet SortedList.
Propriété publiquePris en charge par XNA FrameworkIsFixedSizeObtient une valeur indiquant si un objet SortedList est de taille fixe.
Propriété publiquePris en charge par XNA FrameworkIsReadOnlyObtient une valeur indiquant si un objet SortedList est en lecture seule.
Propriété publiquePris en charge par XNA FrameworkIsSynchronizedObtient une valeur indiquant si l'accès à un objet SortedList est synchronisé (thread-safe).
Propriété publiquePris en charge par XNA FrameworkItemObtient et définit la valeur associée à une clé spécifique dans un objet SortedList.
Propriété publiquePris en charge par XNA FrameworkKeysObtient les clés d'un objet SortedList.
Propriété publiquePris en charge par XNA FrameworkSyncRootObtient un objet qui peut être utilisé pour synchroniser l'accès à un objet SortedList.
Propriété publiquePris en charge par XNA FrameworkValuesObtient les valeurs d'un objet SortedList.
Début

  NomDescription
Méthode publiquePris en charge par XNA FrameworkAddAjoute un élément avec la clé et la valeur spécifiées dans un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkClearSupprime tous les éléments d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkCloneCrée une copie superficielle d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkContainsDétermine si un objet SortedList contient une clé spécifique.
Méthode publiquePris en charge par XNA FrameworkContainsKeyDétermine si un objet SortedList contient une clé spécifique.
Méthode publiquePris en charge par XNA FrameworkContainsValueDétermine si un objet SortedList contient une valeur spécifique.
Méthode publiquePris en charge par XNA FrameworkCopyToCopie des éléments SortedList dans un objet Array unidimensionnel, en commençant à l'index spécifié dans le tableau.
Méthode publiquePris en charge par XNA FrameworkEquals(Object)Détermine si l'objet spécifié est identique à l'objet actuel. (Hérité de Object.)
Méthode protégéePris en charge par XNA FrameworkFinalize 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.)
Méthode publiquePris en charge par XNA FrameworkGetByIndexObtient la valeur à l'index spécifié d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkGetEnumeratorRetourne un objet IDictionaryEnumerator qui itère a sein d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkGetHashCodeSert de fonction de hachage par défaut. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkGetKeyObtient la clé à l'index spécifié d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkGetKeyListObtient les clés d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkGetValueListObtient les valeurs d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkIndexOfKeyRetourne l'index de base zéro de la clé spécifiée dans un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkIndexOfValueRetourne l'index de base zéro de la première occurrence de la valeur spécifiée dans un objet SortedList.
Méthode protégéePris en charge par XNA FrameworkMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkRemoveSupprime d'un objet SortedList l'élément ayant la clé spécifiée.
Méthode publiquePris en charge par XNA FrameworkRemoveAtSupprime l'élément à l'index spécifié d'un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkSetByIndexRemplace la valeur à l'index spécifié dans un objet SortedList.
Méthode publiqueMembre statiquePris en charge par XNA FrameworkSynchronizedRetourne un wrapper synchronisé (thread-safe) pour un objet SortedList.
Méthode publiquePris en charge par XNA FrameworkToStringRetourne une chaîne qui représente l'objet actif. (Hérité de Object.)
Méthode publiquePris en charge par XNA FrameworkTrimToSizeAffecte à la capacité le nombre réel d'éléments d'un objet SortedList.
Début

  NomDescription
Méthode d'extension publiqueAsParallelActive la parallélisation d'une requête. (Défini par ParallelEnumerable.)
Méthode d'extension publiqueAsQueryableConvertit un IEnumerable en IQueryable. (Défini par Queryable.)
Méthode d'extension publiquePris en charge par XNA FrameworkCast<TResult>Effectue un cast des éléments d'un IEnumerable vers le type spécifié. (Défini par Enumerable.)
Méthode d'extension publiquePris en charge par XNA FrameworkOfType<TResult>Filtre les éléments d'un IEnumerable en fonction du type spécifié. (Défini par Enumerable.)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par XNA FrameworkIEnumerable.GetEnumeratorRetourne IEnumerator qui itère au sein de SortedList.
Début

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

Un élément SortedList est accessible par sa clé, au même titre qu'un élément d'une implémentation de IDictionary, ou par son index, comme un élément d'une implémentation de IList.

Un objet SortedList 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 à laquelle on peut accéder en tant qu'objet DictionaryEntry. Une clé ne peut pas être null, contrairement à une valeur.

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

Pour les objets SortedList très grands, vous pouvez augmenter la capacité maximale à 2 milliards d'éléments sur un système 64 bits en définissant l'attribut enabled de l'élément de configuration gcAllowVeryLargeObjects à true dans l'environnement d'exécution.

Les éléments d'un objet SortedList sont triés par les clés, suivant une implémentation spécifique de IComparer spécifiée quand SortedList est créé ou suivant l'implémentation de IComparable fournie par les clés elles-mêmes. Dans les deux cas, SortedList ne tolère pas les clés dupliquées.

La séquence d'index est basée sur la séquence de tri. Quand un élément est ajouté, il est inséré dans SortedList dans l'ordre de tri adéquat, et l'indexation s'ajuste en conséquence. Quand 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 en fonction de l'ajout ou de la suppression d'éléments dans l'objet SortedList.

Les opérations sur un objet SortedList ont tendance à être plus lentes que les opérations sur un objet Hashtable en raison du tri. Cependant, un objet SortedList est plus flexible, car il permet l'accès aux valeurs par l'intermédiaire des clés associées ou des index.

Il est possible d'accéder aux éléments de cette collection en utilisant un index d'entiers. Les index de cette collection sont des index de base zéro.

L'instruction foreach du langage C# (for each en Visual Basic) requiert le type de chaque élément de la collection. Étant donné que chaque élément de l'objet SortedList est une paire clé/valeur, le type d'élément n'est pas le type de la clé, ni le type de la valeur. Le type d'élément est plutôt DictionaryEntry. Par exemple :


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


L'instruction foreach est un wrapper autour de l'énumérateur, qui permet la lecture à partir de la collection, mais non l'écriture dans celle-ci.

L'exemple de code suivant illustre la création et l'initialisation d'un objet SortedList 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:    !
*/


.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Pris en charge dans : 4, 3.5 SP1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

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

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

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 modifier la collection, ce qui entraîne la levée d'une exception par l'énumérateur. Afin de garantir la cohérence de thread au cours de l'énumération, vous pouvez soit verrouiller la collection pendant l'ensemble de l'énumération, soit intercepter les exceptions résultant des modifications apportées par les autres threads.

Ajouts de la communauté

AJOUTER
Afficher:
© 2014 Microsoft