ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IComparable.CompareTo 方法

  • 參考

定義

命名空間:
System
組件:
System.Runtime.dll
組件:
System.ValueTuple.dll
組件:
mscorlib.dll
組件:
netstandard.dll

將目前的 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

帶正負號的整數，可指出此執行個體以及排序次序中 obj 的相對位置，如下表所示。

值 描述
負整數 這個執行個體位於 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) 方法。

這個方法會使用預設物件比較子來比較每個元件。

適用於