IComparer<T> 介面

  • 參考

定義

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

定義類型會實作以比較兩個物件的方法。

generic <typename T>
public interface class IComparer
public interface IComparer<in T>
public interface IComparer<T>
type IComparer<'T> = interface
Public Interface IComparer(Of In T)
Public Interface IComparer(Of T)

類型參數

T

要比較之物件的類型。

這是反變數的型別參數。 也就是說，您可以使用您指定的類型，或衍生程度較低的任何類型。 如需共變數與反變數的詳細資訊，請參閱泛型中的共變數與反變數。
衍生

範例

下列範例會實作 介面， IComparer<T> 根據其維度來比較類型的 Box 物件。 此範例是針對 類別提供的較大範例的 Comparer<T> 一部分。

// This class is not demonstrated in the Main method
// and is provided only to show how to implement
// the interface. It is recommended to derive
// from Comparer<T> instead of implementing IComparer<T>.
public class BoxComp : IComparer<Box>
{
    // Compares by Height, Length, and Width.
    public int Compare(Box x, Box y)
    {
        if (x.Height.CompareTo(y.Height) != 0)
        {
            return x.Height.CompareTo(y.Height);
        }
        else if (x.Length.CompareTo(y.Length) != 0)
        {
            return x.Length.CompareTo(y.Length);
        }
        else if (x.Width.CompareTo(y.Width) != 0)
        {
            return x.Width.CompareTo(y.Width);
        }
        else
        {
            return 0;
        }
    }
}

' This class is not demonstrated in the Main method
' and is provided only to show how to implement
' the interface. It is recommended to derive
' from Comparer<T> instead of implementing IComparer<T>.
Public Class BoxComp
    Implements IComparer(Of Box)
    ' Compares by Height, Length, and Width.
    Public Function Compare(ByVal x As Box, ByVal y As Box) As Integer Implements _
                                                IComparer(Of Box).Compare
        If x.Height.CompareTo(y.Height) <> 0 Then
            Return x.Height.CompareTo(y.Height)
        ElseIf x.Length.CompareTo(y.Length) <> 0 Then
            Return x.Length.CompareTo(y.Length)
        ElseIf x.Width.CompareTo(y.Width) <> 0 Then
            Return x.Width.CompareTo(y.Width)
        Else
            Return 0
        End If
    End Function
End Class

備註

這個介面會與 和 List<T>.BinarySearch 方法搭配List<T>.Sort使用。 它提供自定義集合排序順序的方法。 實作此介面的類別包括 SortedDictionary<TKey,TValue> 和 SortedList<TKey,TValue> 泛型類別。

這個介面的預設實作是 Comparer<T> 類別。 類別會 StringComparer 針對類型 String實作這個介面。

此介面支援排序比較。 也就是說，當方法傳回0時 Compare ，這表示兩個物件會排序相同。 完全相等比較的實作是由泛型介面所 IEqualityComparer<T> 提供。

我們建議您衍生自 Comparer<T> 類別，而不是實作 IComparer<T> 介面，因為 Comparer<T> 類別會提供 方法的明確介面實 IComparer.Compare 作，以及 Default 取得對象預設比較子的屬性。

方法

Compare(T, T)

比較兩個物件並傳回值，指出其中一個物件為小於、等於或大於另一個物件。

適用於

另請參閱