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

Referência

Definição

Namespace:: System.Collections.Generic

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Compara dois objetos e retorna um valor que indica se um é menor, igual ou maior do que o outro.

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

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 zero	`x` é menor que `y`.
Zero	`x` é igual a `y`.
Maior que zero	`x` é maior que `y`.

Exemplos

O exemplo a seguir implementa a IComparer<T> interface para comparar objetos do tipo Box de acordo com suas dimensões. Este exemplo faz parte de um exemplo maior fornecido para a Comparer<T> classe .

// 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

Comentários

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

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.

Aplica-se a

Partilhar via