ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Metoda
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Porównuje bieżące ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> wystąpienie z określonym obiektem przy użyciu określonego porównania i zwraca liczbę całkowitą wskazującą, czy bieżący obiekt znajduje się przed, po, czy w tej samej pozycji co określony obiekt w kolejności sortowania.
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.CompareToParametry
- other
- Object
Obiekt do porównania z bieżącym wystąpieniem.
- comparer
- IComparer
Obiekt, który udostępnia reguły niestandardowe do porównania.
Zwraca
Liczba całkowita ze znakiem wskazująca względną pozycję tego wystąpienia i other w kolejności sortowania, jak pokazano w poniższej tabeli.
| Wartość | Opis |
|---|---|
| Ujemna liczba całkowita | To wystąpienie poprzedza other.
|
| Zero | To wystąpienie i other mają tę samą pozycję w kolejności sortowania.
|
| Dodatnia liczba całkowita | To wystąpienie jest zgodne z .other
|
Implementuje
Wyjątki
other nie jest obiektem ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> .
Uwagi
Ten element członkowski jest jawną implementacją interfejsu. Można go używać tylko wtedy, gdy ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> wystąpienie jest rzutowanie do interfejsu IStructuralComparable .
Ta metoda umożliwia zdefiniowanie dostosowanych ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> porównań obiektów. Można na przykład użyć tej metody, aby porządkować ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> obiekty na podstawie wartości określonego składnika.
Chociaż ta metoda może być wywoływana bezpośrednio, jest ona najczęściej wywoływana przez metody sortowania kolekcji, które zawierają IComparer parametry w celu uporządkowania elementów członkowskich kolekcji. Na przykład jest wywoływana przez metodę Array.Sort(Array, IComparer) i Add metodę SortedList obiektu utworzonego przy użyciu konstruktora SortedList.SortedList(IComparer) .
Caution
Metoda jest przeznaczona IStructuralComparable.CompareTo do użycia w operacjach sortowania. Nie należy jej używać, gdy głównym celem porównania jest określenie, czy dwa obiekty są równe. Aby określić, czy dwa obiekty są równe, wywołaj metodę IStructuralEquatable.Equals .
