ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.IStructuralComparable.CompareTo Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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
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
other
non è un oggetto ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest>.
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 .