IComparer<T>.Compare(T, T) Metodo

Definizione

Confronta due oggetti e restituisce un valore indicante se uno è minore, uguale o maggiore dell'altro.Compares two objects and returns a value indicating whether one is less than, equal to, or greater than the other.

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

Parametri

x
T

Primo oggetto da confrontare.The first object to compare.

y
T

Secondo oggetto da confrontare.The second object to compare.

Restituisce

Intero con segno che indica i valori relativi di x e y, come illustrato nella tabella seguente.A signed integer that indicates the relative values of x and y, as shown in the following table.

ValoreValue SignificatoMeaning
Minore di zeroLess than zero x è minore di y.x is less than y.
ZeroZero x è uguale a y.x equals y.
Maggiore di zeroGreater than zero x è maggiore di y.x is greater than y.

Esempi

Nell'esempio seguente viene implementata l'interfaccia IComparer<T> per confrontare oggetti di tipo Box in base alle relative dimensioni.The following example implements the IComparer<T> interface to compare objects of type Box according to their dimensions. Questo esempio fa parte di un esempio più ampio fornito per la classe Comparer<T>.This example is part of a larger example provided for the Comparer<T> class.

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

Commenti

Implementare questo metodo per fornire un confronto di ordinamento personalizzato per il tipo T.Implement this method to provide a customized sort order comparison for type T.

Il confronto di null con qualsiasi tipo di riferimento è consentito e non genera un'eccezione.Comparing null with any reference type is allowed and does not generate an exception. Un riferimento null è considerato minore di qualsiasi riferimento non null.A null reference is considered to be less than any reference that is not null.

Si applica a

Vedi anche