Comparer<T>.Compare(T, T) Metoda

Definicja

Przestrzeń nazw:

System.Collections.Generic

Zestaw:

System.Collections.dll

Źródło:

Comparer.CoreCLR.cs

Podczas zastępowania w klasie pochodnej wykonuje porównanie dwóch obiektów tego samego typu i zwraca wartość wskazującą, czy jeden obiekt jest mniejszy niż, równy lub większy niż drugi.

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

Parametry

x

T

Pierwszy obiekt do porównania.

y

T

Drugi obiekt do porównania.

Zwraca

Int32

Liczba całkowita ze znakiem wskazująca względne wartości x i y, jak pokazano w poniższej tabeli.

Wartość	Znaczenie
Mniej niż zero	x wartość jest mniejsza niż y.
Zero	x równa ysię .
Większe od zera	x wartość jest większa niż y.

Implementuje

Compare(T, T)

Wyjątki

ArgumentException

Typ T nie implementuje interfejsu IComparable<T> ogólnego ani interfejsu IComparable .

Przykłady

W poniższym przykładzie zdefiniowano porównujący Box obiekty, których można użyć zamiast domyślnego porównania. Ten przykład jest częścią większego przykładu udostępnionego Comparer<T> dla klasy .

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

Uwagi

Zaimplementuj tę metodę, aby zapewnić dostosowane porównanie kolejności sortowania dla typu T.

Uwagi dotyczące implementowania

Porównywanie null z dowolnym typem odwołania jest dozwolone i nie generuje wyjątku. Odwołanie o wartości null jest uznawane za mniejsze niż odwołanie, które nie ma wartości null.

Aby uzyskać informacje na temat porównań specyficznych dla kultury, zobacz System.Globalization przestrzeń nazw i globalizacja i lokalizacja.

Zobacz też

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