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 atual ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> com 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 com sinal 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 | Essa instância precede other.
|
| Zero | Essa instância e other tem 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 ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objeto.
Comentários
Esse 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 esse método possa ser chamado diretamente, ele é mais comumente chamado por métodos de classificação de coleção que incluem IComparer parâmetros para ordenar os membros de uma coleção. Por exemplo, ele é chamado pelo Array.Sort(Array, IComparer) método e pelo Add método de um SortedList objeto instanciado usando o SortedList.SortedList(IComparer) construtor.
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.
