Tuple<T1,T2,T3>.IStructuralComparable.CompareTo Méthode

Définition

Espace de noms:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Source:

Tuple.cs

Compare l'objet Tuple<T1,T2,T3> actif à un objet spécifié à l'aide d'un comparateur spécifié et retourne un entier qui indique si l'objet actif précède, suit ou est dans la même position que l'objet spécifié dans l'ordre de tri.

C#

int IStructuralComparable.CompareTo(object other, System.Collections.IComparer comparer);

Paramètres

other

Object

Objet à comparer à l'instance actuelle.

comparer

IComparer

Un objet qui fournit des règles personnalisées pour la comparaison.

Retours

Int32

Entier signé qui indique la position relative de cette instance et de other dans l’ordre de tri, comme indiqué dans le tableau suivant.

Valeur	Description
Entier négatif	Cette instance précède other.
Zéro	Cette instance et other ont la même position dans l'ordre de tri.
Entier positif	Cette instance suit other.

Implémente

CompareTo(Object, IComparer)

Exceptions

ArgumentException

other n’est pas un objet Tuple<T1,T2,T3>.

Exemples

L’exemple suivant crée un tableau d’objets Tuple<T1,T2,T3> qui se composent du nom d’un étudiant, du score de test moyen et du nombre de tests. Il affiche le composant de chaque tuple dans le tableau dans un ordre non trié, trie le tableau, puis appelle ToString pour afficher la valeur de chaque tuple dans l’ordre trié. Pour trier le tableau, l’exemple définit une classe générique ScoreComparer qui implémente l’interface IComparer et trie les objets dans l’ordre Tuple<T1,T2,T3> croissant en fonction de la valeur de leur deuxième composant plutôt que de leur premier composant. Notez que l’exemple n’appelle pas directement la Tuple<T1,T2,T3>.IStructuralComparable.CompareTo méthode . Cette méthode est appelée implicitement par la Array.Sort(Array, IComparer) méthode pour chaque élément du tableau.

C#

using System;
using System.Collections;
using System.Collections.Generic;

public class ScoreComparer<T1, T2, T3> : IComparer
{
   public int Compare(object x, object y)
   {
      Tuple<T1, T2, T3> tX = x as Tuple<T1,T2, T3>;
      if (tX == null)
      { 
         return 0;
      }   
      else
      {
         Tuple<T1, T2, T3> tY = y as Tuple<T1, T2, T3>;
         return Comparer<T2>.Default.Compare(tX.Item2, tY.Item2);             
      }
   }
}

public class Example
{
   public static void Main()
   {
      Tuple<string, double, int>[] scores = 
                { Tuple.Create("Jack", 78.8, 8),
                  Tuple.Create("Abbey", 92.1, 9), 
                  Tuple.Create("Dave", 88.3, 9),
                  Tuple.Create("Sam", 91.7, 8), 
                  Tuple.Create("Ed", 71.2, 5),
                  Tuple.Create("Penelope", 82.9, 8),
                  Tuple.Create("Linda", 99.0, 9),
                  Tuple.Create("Judith", 84.3, 9) };

      Console.WriteLine("The values in unsorted order:");
      foreach (var score in scores)
         Console.WriteLine(score.ToString());

      Console.WriteLine();

      Array.Sort(scores, new ScoreComparer<string, double, int>());

      Console.WriteLine("The values in sorted order:");
      foreach (var score in scores)
         Console.WriteLine(score.ToString());
   }
}
// The example displays the following output;
//       The values in unsorted order:
//       (Jack, 78.8, 8)
//       (Abbey, 92.1, 9)
//       (Dave, 88.3, 9)
//       (Sam, 91.7, 8)
//       (Ed, 71.2, 5)
//       (Penelope, 82.9, 8)
//       (Linda, 99, 9)
//       (Judith, 84.3, 9)
//       
//       The values in sorted order:
//       (Ed, 71.2, 5)
//       (Jack, 78.8, 8)
//       (Penelope, 82.9, 8)
//       (Judith, 84.3, 9)
//       (Dave, 88.3, 9)
//       (Sam, 91.7, 8)
//       (Abbey, 92.1, 9)
//       (Linda, 99, 9)

Remarques

Ce membre est une implémentation d'un membre d'interface explicite. Il peut uniquement être utilisé lorsque l'instance de Tuple<T1,T2,T3> est castée en interface IStructuralComparable.

Bien que cette méthode puisse être appelée directement, elle est généralement appelée par les méthodes de tri de collection qui incluent des IComparer paramètres pour classer les membres d’une collection. Par exemple, elle est appelée par la Array.Sort(Array, IComparer) méthode et la Add méthode d’un SortedList objet instancié à l’aide du SortedList.SortedList(IComparer) constructeur .

Attention

La Tuple<T1,T2,T3>.IStructuralComparable.CompareTo méthode est destinée à être utilisée dans les opérations de tri. Il ne doit pas être utilisé lorsque l’objectif principal d’une comparaison est de déterminer si deux objets sont égaux. Pour déterminer si deux objets sont égaux, appelez la Tuple<T1,T2,T3>.IStructuralEquatable.Equals méthode .

S’applique à

Voir aussi

• IStructuralEquatable.Equals(Object, IEqualityComparer)