Comparer<T>.Compare(T, T) Método

  • Referência

Definição

Namespace:
System.Collections.Generic
Assembly:
System.Collections.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Origem:
Comparer.CoreCLR.cs
Origem:
Comparer.CoreCLR.cs
Origem:
Comparer.CoreCLR.cs

Quando substituído em uma classe derivada, executa uma comparação de dois objetos do mesmo tipo e retorna um valor que indica se um objeto é menor que, igual a ou maior que o outro.

public:
 abstract int Compare(T x, T y);
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

Parâmetros

x
T

O primeiro objeto a ser comparado.

y
T

O segundo objeto a ser comparado.

Retornos

Int32

Um inteiro assinado que indica os valores relativos de x e y, conforme mostrado na tabela a seguir.

Valor Significado
Menor que zerox é menor que y.
Zerox é igual a y.
Maior que zerox é maior que y.

Implementações

Compare(T, T)

Exceções

ArgumentException

O tipo de T não implementa a interface genérica IComparable<T> ou a interface IComparable.

Exemplos

O exemplo a seguir define um comparador de Box objetos que podem ser usados em vez do comparador padrão. Este exemplo faz parte de um exemplo maior fornecido para a Comparer<T> classe .

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

Comentários

Implemente esse método para fornecer uma comparação de ordem de classificação personalizada para o tipo T.

Notas aos Implementadores

A comparação null com qualquer tipo de referência é permitida e não gera uma exceção. Uma referência nula é considerada menor do que qualquer referência que não seja nula.

Para obter informações sobre comparações específicas da cultura, consulte o System.Globalization namespace e Globalização e Localização.

Aplica-se a

Confira também