ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Método

Definição

Compara a instância ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> atual a um objeto especificado usando um comparador especificado e retorna um inteiro que indica se o objeto atual está antes, depois ou na mesma posição que o objeto especificado na ordem de classificação.

 virtual int System.Collections.IStructuralComparable.CompareTo(System::Object ^ other, System::Collections::IComparer ^ comparer) = System::Collections::IStructuralComparable::CompareTo;
int IStructuralComparable.CompareTo (object other, System.Collections.IComparer comparer);
abstract member System.Collections.IStructuralComparable.CompareTo : obj * System.Collections.IComparer -> int
override this.System.Collections.IStructuralComparable.CompareTo : obj * System.Collections.IComparer -> int
Function CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareTo

Parâmetros

other
Object

O objeto a ser comparado com a instância atual.

comparer
IComparer

Um objeto que fornece regras personalizadas para comparação.

Retornos

Int32

Um inteiro assinado que indica a posição relativa dessa instância e other na ordem de classificação, conforme mostrado na tabela a seguir.

Valor Descrição
Um inteiro negativo Esta instância precede other.
Zero Esta instância e other têm a mesma posição na ordem de classificação.
Um inteiro positivo Esta instância segue other.

Implementações

Exceções

Comentários

Este membro é uma implementação de interface explícita. Ela só pode ser usada quando a ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instância é convertida em uma IStructuralComparable interface.

Esse método permite definir comparações personalizadas de ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objetos. Por exemplo, você pode usar esse método para ordenar ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objetos com base no valor de um componente específico.

Embora possa ser chamado diretamente, esse método é mais comumente chamado pelos métodos de classificação de coleção que incluem parâmetros IComparer para classificar os membros de uma coleção. Por exemplo, ele é chamado pelo método Array.Sort(Array, IComparer) e pelo método Add de um objeto SortedList que é instanciado usando-se o construtor SortedList.SortedList(IComparer).

Cuidado

O IStructuralComparable.CompareTo método destina-se ao uso em operações de classificação. Ele não deve ser usado quando a finalidade principal de uma comparação é determinar se dois objetos são iguais. Para determinar se dois objetos são iguais, chame o IStructuralEquatable.Equals método.

Aplica-se a