Comparer<T>.Compare(T, T) Метод

Определение

Пространство имен:

System.Collections.Generic

Сборка:

System.Collections.dll

Исходный код:

Comparer.CoreCLR.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;
        }
    }
}

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.

Сведения о сравнениях для конкретного языка и региональных параметров см. в System.Globalization разделах Пространство имен и Глобализация и локализация.

См. также раздел

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