ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IComparable.CompareTo Метод

Определение

Пространство имен:

System

Сборка:

System.Runtime.dll

Исходный код:

ValueTuple.cs

Сравнивает текущий объект ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> с указанным объектом и возвращает целое число, указывающее, является ли текущий объект до, после или в той же позиции, что и указанный объект в порядке сортировки.

 virtual int System.IComparable.CompareTo(System::Object ^ other) = IComparable::CompareTo;

int IComparable.CompareTo (object other);

abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int

Function CompareTo (other As Object) As Integer Implements IComparable.CompareTo

Параметры

other

Object

Объект для сравнения с текущим экземпляром.

Возвращаемое значение

Int32

Целое число со знаком, указывающее относительную позицию этого экземпляра и other в порядке сортировки, как показано в следующей таблице.

Ценность	Описание
Отрицательное целое число	Этот экземпляр предшествует other.
Нуль	Этот экземпляр и other имеют ту же позицию в порядке сортировки.
Положительное целое число	Этот экземпляр следует other.

Реализации

CompareTo(Object)

Исключения

ArgumentException

other не является объектом ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.

Комментарии

Этот член является явной реализацией элемента интерфейса. Его можно использовать только в том случае, если экземпляр ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> приведение к интерфейсу IComparable.

Этот метод предоставляет реализацию IComparable.CompareTo для структуры ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>. Хотя метод можно вызывать напрямую, он чаще всего вызывается перегрузками по умолчанию методов сортировки коллекций, например Array.Sort(Array) и SortedList.Add, для упорядочивания элементов коллекции.

Осторожность

Метод ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IComparable.CompareTo предназначен для использования в операциях сортировки. Его не следует использовать, если основная цель сравнения заключается в определении того, равны ли два объекта. Чтобы определить, равны ли два объекта, вызовите метод ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Equals(Object).

Этот метод использует средство сравнения объектов по умолчанию для сравнения каждого компонента.