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

Определение

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

System

Сборка:

System.Runtime.dll

Сборка:

System.ValueTuple.dll

Сборка:

mscorlib.dll

Сборка:

netstandard.dll

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

 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

Параметры

other

Object

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

comparer

IComparer

Объект, предоставляющий настраиваемые правила для сравнения.

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

Int32

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

Значение	Описание
Отрицательное целое число	Данный экземпляр предшествует параметру other.
Нуль	У этого экземпляра та же позиция в порядке сортировки, что и у other.
Положительное целое число	Данный экземпляр стоит после параметра other.

Реализации

CompareTo(Object, IComparer)

Исключения

ArgumentException

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

Комментарии

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

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

Хотя этот метод можно вызывать напрямую, он чаще всего вызывается методами сортировки коллекции, включающими IComparer параметры для упорядочивания элементов коллекции. Например, он вызывается методом и методом SortedList объекта, который создается с помощью конструктораSortedList.SortedList(IComparer).Add Array.Sort(Array, IComparer)

Внимание!

Этот IStructuralComparable.CompareTo метод предназначен для использования в операциях сортировки. Его не следует использовать, если основной целью сравнения является определение того, равны ли два объекта. Чтобы определить, равны ли два объекта, вызовите IStructuralEquatable.Equals метод.