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

Definizione

Confronta l'istanza corrente di ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> con un oggetto specificato usando un operatore di confronto specificato e restituisce un intero che indica se l'oggetto corrente precede, segue o si trova 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.

Restituisce

Int32

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

Valore Descrizione
Intero negativo Questa istanza precede other.
Zero Questa istanza si trova nella stessa posizione di other nell'ordinamento.
Intero positivo L'istanza segue other.

Implementazioni

Eccezioni

Commenti

Il 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 utilizzato 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 .

Si applica a