Comparer<T>.Compare(T, T) メソッド

定義

名前空間:

System.Collections.Generic

アセンブリ:

System.Collections.dll

ソース:

Comparer.CoreCLR.cs

派生クラスでオーバーライドされると、同じ型の 2 つのオブジェクトに対する比較を実行し、一方のオブジェクトが他方よりも小さいか、等しいか、大きいかを示す値を返します。

public:
 abstract int Compare(T x, T y);

public abstract int Compare (T? x, T? y);

abstract member Compare : 'T * 'T -> int

Public MustOverride Function Compare (x As T, y As T) As Integer

パラメーター

x

T

比較する最初のオブジェクト。

y

T

比較する 2 番目のオブジェクト。

戻り値

Int32

x と y の相対値を示す符号付き整数。次の表を参照してください。

[値]	説明
0 より小さい値	x は y より小さい値です。
ゼロ	x と y は等しい。
0 より大きい値	x が y より大きくなっています。

実装

Compare(T, T)

例外

ArgumentException

T 型が、IComparable<T> ジェネリック インターフェイスと IComparable インターフェイスのいずれも実装していません。

例

次の例では、既定の比較子の Box 代わりに使用できるオブジェクトの比較子を定義します。 この例は、 クラスに対して提供されるより大きな例の Comparer<T> 一部です。

public class BoxLengthFirst : Comparer<Box>
{
    // Compares by Length, Height, and Width.
    public override int Compare(Box x, Box y)
    {
        if (x.Length.CompareTo(y.Length) != 0)
        {
            return x.Length.CompareTo(y.Length);
        }
        else if (x.Height.CompareTo(y.Height) != 0)
        {
            return x.Height.CompareTo(y.Height);
        }
        else if (x.Width.CompareTo(y.Width) != 0)
        {
            return x.Width.CompareTo(y.Width);
        }
        else
        {
            return 0;
        }
    }
}

Public Class BoxLengthFirst
    Inherits Comparer(Of Box)
    ' Compares by Length, Height, and Width.
    Public Overrides Function Compare(ByVal x As Box, ByVal y As Box) As Integer
        If x.Length.CompareTo(y.Length) <> 0 Then
            Return x.Length.CompareTo(y.Length)
        ElseIf x.Height.CompareTo(y.Height) <> 0 Then
            Return x.Height.CompareTo(y.Height)
        ElseIf x.Width.CompareTo(y.Width) <> 0 Then
            Return x.Width.CompareTo(y.Width)
        Else
            Return 0
        End If
    End Function

End Class

注釈

型のカスタマイズされた並べ替え順序の比較を提供するには、このメソッドを実装します T。

注意 (実装者)

null参照型との比較は許可され、例外は生成されません。 null 参照は、null ではない参照よりも小さいと見なされます。

カルチャ固有の比較の詳細については、名前空間とグローバリゼーションとローカライズにSystem.Globalization関するページを参照してください。

こちらもご覧ください

• IComparable<T>
• IComparable
• StringComparer
• Object
• CultureInfo