IComparer<T> Interface

Definição

Espaço de Nomes:
System.Collections.Generic
Assemblagens:
mscorlib.dll, System.Runtime.dll
Assemblagens:
netstandard.dll, System.Runtime.dll
Assemblagem:
System.Runtime.dll
Assemblagem:
mscorlib.dll
Assemblagem:
netstandard.dll
Origem:
IComparer.cs
Origem:
IComparer.cs
Origem:
TupleExtensions.cs

Define um método que um tipo implementa para comparar dois objetos.

generic <typename T>
public interface class IComparer
public interface IComparer<in T>
public interface IComparer<in T> where T : allows ref struct
public interface IComparer<T>
type IComparer<'T> = interface
Public Interface IComparer(Of In T)
Public Interface IComparer(Of T)

Parâmetros de Tipo Genérico

T

O tipo de objetos a comparar.

Este parâmetro de tipo é contravariante. Ou seja, pode utilizar o tipo que especificou ou qualquer tipo que seja menos derivado. Para obter mais informações sobre covariância e contravariância, veja Covariância e Contravariância em Genérico.
Derivado

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

Esta interface é usada com os List<T>.Sort métodos e List<T>.BinarySearch . Oferece uma forma de personalizar a ordem de ordenação de uma coleção. As classes que implementam esta interface incluem as SortedDictionary<TKey,TValue> classes genéricas e SortedList<TKey,TValue> .

A implementação padrão desta interface é a Comparer<T> classe. A StringComparer classe implementa esta interface para o tipo String.

Esta interface suporta comparações de ordenação. Ou seja, quando o Compare método retorna 0, significa que dois objetos ordenam da mesma forma. A implementação das comparações de igualdade exata é assegurada pela IEqualityComparer<T> interface genérica.

Recomendamos que derive da Comparer<T> classe em vez de implementar a IComparer<T> interface, porque a Comparer<T> classe fornece uma implementação explícita da interface do IComparer.Compare método e a Default propriedade que obtém o comparador padrão para o objeto.

Métodos

Name Description
Compare(T, T)

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

Aplica-se a

Ver também