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> 对象。

注解

此成员是显式接口应用。 仅当实例转换为IStructuralComparable接口时ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>，才能使用它。

使用此方法可以定义对象的自定义比较 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> 。 例如，可以使用此方法根据特定组件的值对对象进行排序 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> 。

尽管可以直接调用此方法，但通常通过集合排序方法调用该方法，这些方法包括 IComparer 参数来对集合的成员进行排序。 例如，该方法和Array.Sort(Array, IComparer)Add通过使用SortedList.SortedList(IComparer)构造函数实例化的对象的方法SortedList调用。

注意

该方法 IStructuralComparable.CompareTo 用于排序操作。 当比较的主要用途是确定两个对象是否相等时，不应使用它。 若要确定两个对象是否相等，请调用 IStructuralEquatable.Equals 该方法。