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

Definizione

Spazio dei nomi:

System

Assembly:

netstandard.dll, System.Runtime.dll

Origine:

ValueTuple.cs

Confronta l'istanza corrente ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> con un oggetto specificato utilizzando un operatore di confronto specificato e restituisce un intero che indica se l'oggetto corrente è prima, dopo o nella stessa posizione dell'oggetto specificato nell'ordinamento.

 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

Parametri

other

Object

Oggetto da confrontare con l'istanza corrente.

comparer

IComparer

Oggetto che fornisce regole personalizzate per il confronto.

Valori restituiti

Int32

Intero con segno che indica la posizione relativa di questa istanza e other nell'ordinamento, come illustrato nella tabella seguente.

Valore	Descrizione
Intero negativo	Questa istanza precede other.
Zero	Questa istanza e other ha la stessa posizione nell'ordinamento.
Intero positivo	Questa istanza segue other.

Implementazioni

CompareTo(Object, IComparer)

Eccezioni

ArgumentException

other non è un ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> oggetto .

Commenti

Questo membro è un'implementazione esplicita dell'interfaccia. Può essere usato solo quando viene eseguito il cast dell'istanza ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> a un'interfaccia IStructuralComparable .

Questo metodo consente di definire confronti personalizzati di ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> oggetti. Ad esempio, è possibile utilizzare questo metodo per ordinare ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> gli oggetti in base al valore di un componente specifico.

Anche se questo metodo può essere chiamato direttamente, viene comunemente chiamato dai metodi di ordinamento delle raccolte che includono IComparer parametri per ordinare i membri di una raccolta. Ad esempio, viene chiamato dal Array.Sort(Array, IComparer) metodo e dal Add metodo di un oggetto di cui viene creata un'istanza SortedList usando il SortedList.SortedList(IComparer) costruttore .

Attenzione

Il IStructuralComparable.CompareTo metodo è destinato all'uso nelle operazioni di ordinamento. Non deve essere usato quando lo scopo principale di un confronto è determinare se due oggetti sono uguali. Per determinare se due oggetti sono uguali, chiamare il IStructuralEquatable.Equals metodo .