ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Méthode
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.
Compare l’instance ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> actuelle à un objet spécifié en utilisant un comparateur spécifié et renvoie un entier qui indique si l’objet actuel est avant, après ou à la même position que l’objet spécifié dans l’ordre de tri.
virtual int System.Collections.IStructuralComparable.CompareTo(System::Object ^ other, System::Collections::IComparer ^ comparer) = System::Collections::IStructuralComparable::CompareTo;
int IStructuralComparable.CompareTo (object other, System.Collections.IComparer comparer);
abstract member System.Collections.IStructuralComparable.CompareTo : obj * System.Collections.IComparer -> int
override this.System.Collections.IStructuralComparable.CompareTo : obj * System.Collections.IComparer -> int
Function CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareTo
Paramètres
- other
- Object
Objet à comparer à l’instance actuelle.
- comparer
- IComparer
Un objet qui fournit des règles personnalisées pour la comparaison.
Retours
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
Exceptions
other
n’est pas un objet ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.
Remarques
Ce membre est une implémentation d'interface explicite. Elle ne peut être utilisée que lorsque l’instance ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> est convertie en interface IStructuralComparable .
Cette méthode vous permet de définir des comparaisons personnalisées d’objets ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> . Par exemple, vous pouvez utiliser cette méthode pour classer ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> les objets en fonction de la valeur d’un composant spécifique.
Bien que cette méthode puisse être appelée directement, elle est généralement appelée par des 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 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 IStructuralEquatable.Equals méthode.