# IComparer<T>IComparer<T>IComparer<T>IComparer<T> Interface

## Definizione

Definisce un metodo che un tipo implementa per confrontare due oggetti.Defines a method that a type implements to compare two objects.

``````generic <typename T>
public interface class IComparer``````
``public interface IComparer<in T>``
``type IComparer<'T> = interface``
``Public Interface IComparer(Of In T)``

#### Parametri di tipo

T

Tipo di oggetti da confrontare.The type of objects to compare.

Derivato

## Esempi

Nell'esempio seguente viene implementata l' IComparer<T> interfaccia 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 Comparer<T> la classe.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

Questa interfaccia viene utilizzata con i List<T>.Sort metodi List<T>.BinarySearch e.This interface is used with the List<T>.Sort and List<T>.BinarySearch methods. Fornisce un modo per personalizzare l'ordinamento di una raccolta.It provides a way to customize the sort order of a collection. Le classi che implementano questa interfaccia SortedDictionary<TKey,TValue> includono SortedList<TKey,TValue> le classi generiche e.Classes that implement this interface include the SortedDictionary<TKey,TValue> and SortedList<TKey,TValue> generic classes.

L'implementazione predefinita di questa interfaccia è la Comparer<T> classe.The default implementation of this interface is the Comparer<T> class. La StringComparer classe implementa questa interfaccia per il Stringtipo.The StringComparer class implements this interface for type String.

Questa interfaccia supporta l'ordinamento di confronti.This interface supports ordering comparisons. Ovvero, quando il Compare metodo restituisce 0, significa che due oggetti ordinano lo stesso.That is, when the Compare method returns 0, it means that two objects sort the same. L' IEqualityComparer<T> implementazione di confronti di uguaglianza esatti viene fornita dall'interfaccia generica.Implementation of exact equality comparisons is provided by the IEqualityComparer<T> generic interface.

È Comparer<T> consigliabile derivare dalla classe anziché implementare l' IComparer<T> interfaccia, perché la Comparer<T> IComparer.Compare classe fornisce un'implementazione esplicita dell'interfaccia del metodo e della Default proprietà che Ottiene l'operatore di confronto predefinito per l'oggetto.We recommend that you derive from the Comparer<T> class instead of implementing the IComparer<T> interface, because the Comparer<T> class provides an explicit interface implementation of the IComparer.Compare method and the Default property that gets the default comparer for the object.

## Metodi

 Compare(T, T) Compare(T, T) Compare(T, T) Compare(T, T) 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.