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 actual ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> con un objeto especificado mediante un comparador especificado y devuelve un entero que indica si el objeto actual es antes, después o 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
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, como se muestra en la tabla siguiente.
| Valor | Descripción |
|---|---|
| Entero negativo | Esta instancia precede a other.
|
| Cero | Esta instancia y other tienen la misma posición en el criterio de ordenación.
|
| Entero positivo | Esta instancia sigue othera .
|
Implementaciones
Excepciones
other no es un ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objeto .
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 directamente a este método, suele llamarse mediante métodos de ordenación de colección 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 .
Caution
El IStructuralComparable.CompareTo método está diseñado 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 .
