ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Metoda

Definicja

Przestrzeń nazw:

System

Zestaw:

System.Runtime.dll

Zestaw:

System.ValueTuple.dll

Zestaw:

mscorlib.dll

Zestaw:

netstandard.dll

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 -> int

Function CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareTo

Parametry

other

Object

Obiekt do porównania z bieżącym wystąpieniem.

comparer

IComparer

Obiekt dostarczający niestandardowe reguły na potrzeby porównania.

Zwraca

Int32

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

CompareTo(Object, IComparer)

Wyjątki

ArgumentException

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 rzutowe do interfejsu IStructuralComparable .

Ta metoda umożliwia definiowanie dostosowanych ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> porównań obiektów. Za pomocą tej metody można na przykład 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 służące do porządkowenia elementów członkowskich kolekcji. Na przykład jest wywoływana przez metodę Array.Sort(Array, IComparer) i Add metodę SortedList obiektu, który jest tworzone przy użyciu konstruktora SortedList.SortedList(IComparer) .

Przestroga

Metoda jest przeznaczona IStructuralComparable.CompareTo do użycia w operacjach sortowania. Nie należy jej używać, gdy głównym celem porównania jest ustalenie, czy dwa obiekty są sobie równe. Aby określić, czy dwa obiekty są równe, wywołaj metodę IStructuralEquatable.Equals .