IComparer<T>.Compare(T, T) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Compara dois objetos e devolve um valor que indica se um é menor, igual ou maior que o outro.
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 comparar.
- y
- T
O segundo objeto para comparar.
Devoluções
Um inteiro com sinal que indica os valores relativos de x e y, conforme mostrado na tabela seguinte.
| Valor | Significado |
|---|---|
| Menos que zero |
x é inferior a y.
|
| Zero |
x igual a y.
|
| Maior que zero |
x é maior que y.
|
Exemplos
O exemplo seguinte implementa a IComparer<T> interface para comparar objetos de tipo Box de acordo com as suas dimensões. Este exemplo faz parte de um exemplo mais amplo fornecido à Comparer<T> turma.
// 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
Observações
Implemente este método para fornecer uma comparação personalizada da ordem de ordenação para o tipo T.
Comparar null com qualquer tipo de referência é permitido e não gera exceção. Uma referência nula é considerada menor do que qualquer referência que não seja nula.