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

Definición

Compara la instancia de ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> actual con un objeto especificado mediante un comparador especificado y devuelve un entero que indica si el objeto actual es anterior, posterior o está en la misma posición que el objeto especificado en el criterio de ordenación.

 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

Objeto que se va a comparar con la instancia actual.

comparer
IComparer

Un objeto que proporciona reglas personalizadas para la comparación.

Devoluciones

Int32

Entero con signo que indica la posición relativa de esta instancia y other en el criterio de ordenación, tal como se muestra en la tabla siguiente.

Valor Descripción
Un entero negativo Esta instancia precede a other.
Cero En el criterio de ordenación, esta instancia y other tienen la misma posición.
Un entero positivo. Esta instancia es posterior a other.

Implementaciones

Excepciones

Comentarios

Este miembro es una implementación de interfaz explícita. Solo se puede usar cuando la ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instancia se convierte en una IStructuralComparable interfaz.

Este método permite definir comparaciones personalizadas de ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objetos. Por ejemplo, puede usar este método para ordenar ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objetos en función del valor de un componente específico.

Aunque se puede llamar a este método directamente, normalmente se llama mediante métodos de ordenación de colecciones que incluyen IComparer parámetros para ordenar los miembros de una colección. Por ejemplo, se llama mediante el Array.Sort(Array, IComparer) método y el Add método de un SortedList objeto al que se crea una instancia mediante el SortedList.SortedList(IComparer) constructor .

Precaución

El IStructuralComparable.CompareTo método está pensado para su uso en operaciones de ordenación. No se debe usar cuando el propósito principal de una comparación es determinar si dos objetos son iguales. Para determinar si dos objetos son iguales, llame al IStructuralEquatable.Equals método .

Se aplica a