ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 -> intFunction CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareToPará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
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
other no es un objeto ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.
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 .