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

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Origem:

ValueTuple.cs

Compara o objeto ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> atual com um objeto 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.IComparable.CompareTo(System::Object ^ other) = IComparable::CompareTo;

int IComparable.CompareTo (object other);

abstract member System.IComparable.CompareTo : obj -> int
override this.System.IComparable.CompareTo : obj -> int

Function CompareTo (other As Object) As Integer Implements IComparable.CompareTo

Parâmetros

other

Object

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

Retornos

Int32

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 têm a mesma posição na ordem de classificação.
Um inteiro positivo	Esta instância segue other.

Implementações

CompareTo(Object)

Exceções

ArgumentException

other não é um objeto ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.

Comentários

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

Esse método fornece a implementação IComparable.CompareTo para a estrutura de ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>. Embora o método possa ser chamado diretamente, ele é mais comumente chamado pelas sobrecargas padrão de métodos de classificação de coleção, como Array.Sort(Array) e SortedList.Add, para ordenar os membros de uma coleção.

Cuidado

O método ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IComparable.CompareTo 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 método ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Equals(Object).

Esse método usa o comparador de objeto padrão para comparar cada componente.