ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo(Object, IComparer) ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo(Object, IComparer) ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo(Object, IComparer) Method

Определение

Сравнивает текущий экземпляр ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> с заданным объектом, используя указанную функцию сравнения, и возвращает целое число, определяющее, находится ли текущий объект в той же позиции, что и указанный объект, после него или перед ним в порядке сортировки.Compares the current ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instance to a specified object by using a specified comparer and returns an integer that indicates whether the current object is before, after, or in the same position as the specified object in the sort order.

 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);
Function CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareTo

Параметры

other
Object Object Object

Объект для сравнения с текущим экземпляром.The object to compare with the current instance.

comparer
IComparer IComparer IComparer

Объект, предоставляющий настраиваемые правила для сравнения.An object that provides custom rules for comparison.

Возвраты

Целое число со знаком, определяющее относительное положение экземпляра и параметра other в порядке сортировки, как показано в следующей таблице.A signed integer that indicates the relative position of this instance and other in the sort order, as shown in the following table.

ЗначениеValue ОписаниеDescription
Отрицательное целое числоA negative integer Данный экземпляр предшествует параметру other.This instance precedes other.
НульZero У этого экземпляра та же позиция в порядке сортировки, что и у other.This instance and other have the same position in the sort order.
Положительное целое числоA positive integer Данный экземпляр стоит после параметра other.This instance follows other.

Реализации

Исключения

Комментарии

Данный член является явной реализацией интерфейса.This member is an explicit interface implementation. Это может быть только используется, когда ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> экземпляр приводится к IStructuralComparable интерфейс.It can only be used when the ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instance is cast to an IStructuralComparable interface.

Этот метод позволяет определять пользовательские процедуры сравнения для ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> объектов.This method lets you define customized comparisons of ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objects. Например, можно использовать этот метод, чтобы порядок ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> объекты на основе значения из указанного компонента.For example, you can use this method to order ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objects based on the value of a specific component.

Несмотря на то, что этот метод может вызываться напрямую, он наиболее часто вызывается сортировки коллекций методы, которые включают IComparer параметры для сортировки элементов в коллекцию.Although this method can be called directly, it is most commonly called by collection-sorting methods that include IComparer parameters to order the members of a collection. Например, она будет вызвана Array.Sort(Array, IComparer) метод и Add метод SortedList объекта, экземпляр которого создается с помощью SortedList.SortedList(IComparer) конструктор.For example, it is called by the Array.Sort(Array, IComparer) method and the Add method of a SortedList object that is instantiated by using the SortedList.SortedList(IComparer) constructor.

Внимание!

IStructuralComparable.CompareTo Метод предназначен для использования в операции сортировки.The IStructuralComparable.CompareTo method is intended for use in sorting operations. Он не должен использоваться, при основной целью сравнения для определения, равны ли два объекта.It should not be used when the primary purpose of a comparison is to determine whether two objects are equal. Чтобы определить, равны ли два объекта, вызовите IStructuralEquatable.Equals метод.To determine whether two objects are equal, call the IStructuralEquatable.Equals method.

Применяется к