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

Definice

Obor názvů:

System

Sestavení:

System.Runtime.dll

Sestavení:

System.ValueTuple.dll

Sestavení:

mscorlib.dll

Sestavení:

netstandard.dll

Porovná aktuální ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instanci se zadaným objektem pomocí zadaného porovnávače a vrátí celé číslo, které označuje, zda je aktuální objekt před, za nebo ve stejné pozici jako zadaný objekt v pořadí řazení.

 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

Objekt k porovnání s aktuální instancí.

comparer

IComparer

Objekt, který poskytuje vlastní pravidla pro porovnání.

Návraty

Int32

Celé číslo se znaménkem, které označuje relativní pozici této instance a other v pořadí řazení, jak je znázorněno v následující tabulce.

Hodnota	Popis
Záporné celé číslo	Tato instance předchází other.
Žádnou	Tato instance a other má stejnou pozici v pořadí řazení.
Kladné celé číslo	Tato instance následuje other.

Implementuje

CompareTo(Object, IComparer)

Výjimky

ArgumentException

other není ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objekt.

Poznámky

Tento člen je explicitní implementací rozhraní. Dá se použít pouze v ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> případě, že je instance přetypována do IStructuralComparable rozhraní.

Tato metoda umožňuje definovat přizpůsobená porovnání ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objektů. Tuto metodu můžete například použít k seřazení ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objektů na základě hodnoty konkrétní komponenty.

I když se tato metoda dá volat přímo, nejčastěji se nazývá metodami řazení kolekcí, které zahrnují IComparer parametry pro pořadí členů kolekce. Volá se například metodou Array.Sort(Array, IComparer) a Add metodou SortedList objektu, který je vytvořena pomocí konstruktoru SortedList.SortedList(IComparer) .

Upozornění

Metoda IStructuralComparable.CompareTo je určena k použití v operacích řazení. Není vhodné jej používat, pokud je primárním účelem porovnání zjištění, zda se dva objekty rovnají. Chcete-li zjistit, zda jsou dva objekty stejné, zavolejte metodu IStructuralEquatable.Equals .