ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IComparable.CompareTo 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
比較目前 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
要與目前實例比較的物件。
傳回
帶正負號的整數,表示這個實例的相對位置,並以排序順序 other
,如下表所示。
價值 | 描述 |
---|---|
負整數 | 這個實例在 other 之前。
|
零 | 這個實例和 other 在排序順序中具有相同的位置。
|
正整數 | 此實體會遵循 other 。
|
實作
例外狀況
other
不是 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> 物件。
備註
這個成員是明確的介面成員實作。 只有當 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> 實例轉換成 IComparable 介面時,才能使用它。
這個方法提供 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> 結構的 IComparable.CompareTo 實作。 雖然可以直接呼叫 方法,但最常由集合排序方法的預設多載呼叫,例如 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) 方法。
這個方法會使用預設對象比較子來比較每個元件。