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

Определение

Сравнение двух объектов и возврат значения, указывающего, является ли один объект меньшим, равным или большим другого.

public:
 int Compare(T x, T y);
public int Compare (T x, T y);
public int Compare (T? x, T? y);
abstract member Compare : 'T * 'T -> int
Public Function Compare (x As T, y As T) As Integer

Параметры

x
T

Первый из сравниваемых объектов.

y
T

Второй из сравниваемых объектов.

Возвращаемое значение

Знаковое целое число, которое определяет относительные значения параметров x и y, как показано в следующей таблице.

Значение Значение
Меньше нуляЗначение x меньше y.
Нульx равняется y.
Больше нуляЗначение x больше значения y.

Примеры

В следующем примере реализуется 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

Комментарии

Реализуйте этот метод для предоставления настраиваемого сравнения порядка сортировки для типа T.

null Сравнение с любым ссылочным типом разрешено и не создает исключение. Пустая ссылка считается меньше любой ссылки, которая не имеет значения NULL.

Применяется к

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