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

Definition

Jämför den aktuella ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> instansen med ett angivet objekt med hjälp av en angiven jämförelse och returnerar ett heltal som anger om det aktuella objektet är före, efter eller i samma position som det angivna objektet i sorteringsordningen.

 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

Parametrar

other
Object

Det objekt som ska jämföras med den aktuella instansen.

comparer
IComparer

Ett objekt som tillhandahåller anpassade regler för jämförelse.

Returer

Ett signerat heltal som anger den relativa positionen för den här instansen och other i sorteringsordningen, enligt följande tabell.

Värde Beskrivning
Ett negativt heltal Den här instansen föregår other.
Noll Den här instansen och other har samma position i sorteringsordningen.
Ett positivt heltal Den här instansen följer other.

Implementeringar

Undantag

Kommentarer

Den här medlemmen är en explicit gränssnittsimplementering. Den kan bara användas när instansen ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> skickas till ett IStructuralComparable gränssnitt.

Med den här metoden kan du definiera anpassade jämförelser av ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objekt. Du kan till exempel använda den här metoden för att beställa ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> objekt baserat på värdet för en specifik komponent.

Även om den här metoden kan anropas direkt, kallas den oftast av insamlingssorteringsmetoder som innehåller IComparer parametrar för att beställa medlemmar i en samling. Den anropas till exempel av Array.Sort(Array, IComparer) metoden och Add metoden för ett SortedList objekt som instansieras med hjälp SortedList.SortedList(IComparer) av konstruktorn.

Caution

Metoden IStructuralComparable.CompareTo är avsedd att användas i sorteringsåtgärder. Den bör inte användas när det primära syftet med en jämförelse är att avgöra om två objekt är lika med. Om du vill avgöra om två objekt är lika med anropar du IStructuralEquatable.Equals metoden.

Gäller för