Comparer<T>.Compare(T, T) 方法

定义

命名空间:

System.Collections.Generic

程序集:

netstandard.dll, System.Collections.dll

Source:

Comparer.cs

在派生类中重写时，对同一类型的两个对象执行比较，并返回一个值，该值指示一个对象是小于、等于还是大于另一个对象。

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

要比较的第二个对象。

返回

Int32

一个有符号整数，指示其相对值 x ， y如下表所示。

值	意义
小于零	x 小于 y。
零	x 等于 y。
大于零	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;
        }
    }
}

type BoxLengthFirst() =
    inherit Comparer<Box>()

    // Compares by Length, Height, and Width.
    override _.Compare(x: Box, y: Box) =
        if x.Length.CompareTo y.Length <> 0 then
            x.Length.CompareTo y.Length
        elif x.Height.CompareTo y.Height <> 0 then
            x.Height.CompareTo y.Height
        elif x.Width.CompareTo y.Width <> 0 then
            x.Width.CompareTo y.Width
        else
            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