ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> intFunction CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareToParâ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
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
other não é um objeto ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.
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.