Tuple<T1>.IStructuralComparable.CompareTo(Object, IComparer) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Vergleicht das aktuelle Tuple<T1> Objekt mit einem angegebenen Objekt mithilfe eines angegebenen Vergleichs und gibt eine ganze Zahl zurück, die angibt, ob das aktuelle Objekt vor, nach oder in derselben Position wie das angegebene Objekt in der Sortierreihenfolge liegt.
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 -> intFunction CompareTo (other As Object, comparer As IComparer) As Integer Implements IStructuralComparable.CompareToParameter
- other
- Object
Ein Objekt, das mit der aktuellen Instanz verglichen werden soll.
- comparer
- IComparer
Ein Objekt, das benutzerdefinierte Regeln für den Vergleich bereitstellt.
Gibt zurück
Eine signierte ganze Zahl, die die relative Position dieser Instanz und other in der Sortierreihenfolge angibt, wie in der folgenden Tabelle dargestellt.
| Wert: | Beschreibung |
|---|---|
| Eine negative ganze Zahl | Diese Instanz steht vor other.
|
| Null | Diese Instanz und other haben dieselbe Position in der Sortierreihenfolge.
|
| Eine positive ganze Zahl | Diese Instanz folgt other.
|
Implementiert
Ausnahmen
other ist kein Tuple<T1> Objekt.
Beispiele
Im folgenden Beispiel wird eine generische Klasse definiert DescendingComparer , die die IComparer<T> Schnittstelle implementiert.
DescendingComparer sortiert Objekte in absteigender und nicht aufsteigender Reihenfolge, indem der vom Standardabgleichwert für einen bestimmten Typ zurückgegebene Wert umgekehrt wird. Anschließend wird eine Instanz der generischen DescendingComparer Klasse an die Array.Sort(Array, IComparer) Methode übergeben, um ein Array von Tuple<T1> Objekten in absteigender Reihenfolge zu sortieren. Beachten Sie, dass das Beispiel die IStructuralComparable.CompareTo Methode nicht direkt aufruft. Diese Methode wird implizit von der Array.Sort(Array, IComparer) Methode für jedes Element im Array aufgerufen.
using System;
using System.Collections.Generic;
public class DescendingComparer<T> : IComparer<T>
{
public int Compare(T x, T y)
{
return -1 * Comparer<T>.Default.Compare(x, y);
}
}
class CompareTo2
{
static void Main()
{
Tuple<Double>[] values = { Tuple.Create(13.54),
Tuple.Create(Double.NaN),
Tuple.Create(-189.42993),
Tuple.Create(Double.PositiveInfinity),
Tuple.Create(Double.Epsilon),
Tuple.Create(1.934E-17),
Tuple.Create(Double.NegativeInfinity),
Tuple.Create(-0.000000000003588),
null };
Console.WriteLine("The values in unsorted order:");
foreach (var value in values)
if (value != null)
Console.WriteLine(" {0}", value.Item1);
else
Console.WriteLine(" <null>");
Console.WriteLine();
Array.Sort(values, new DescendingComparer<Tuple<Double>>());
Console.WriteLine("The values sorted in descending order:");
foreach (var value in values)
if (value != null)
Console.WriteLine(" {0}", value.Item1);
else
Console.WriteLine(" <null>");
}
}
// The example displays the following output:
// The values in unsorted order:
// 13.54
// NaN
// -189.42993
// Infinity
// 4.94065645841247E-324
// 1.934E-17
// -Infinity
// -3.588E-12
//
// The values sorted in descending order:
// Infinity
// 13.54
// 1.934E-17
// 4.94065645841247E-324
// -3.588E-12
// -189.42993
// -Infinity
// NaN
open System
open System.Collections.Generic
type DescendingComparer<'T>() =
interface IComparer<'T> with
member _.Compare(x: 'T, y: 'T) =
-1 * Comparer<'T>.Default.Compare(x, y)
let values =
[| Tuple.Create 13.54
Tuple.Create Double.NaN
Tuple.Create -189.42993
Tuple.Create Double.PositiveInfinity
Tuple.Create Double.Epsilon
Tuple.Create 1.934E-17
Tuple.Create Double.NegativeInfinity
Tuple.Create -0.000000000003588
null |]
printfn "The values in unsorted order:"
for value in values do
printfn $" %A{value.Item1}"
printfn ""
Array.Sort(values, DescendingComparer<Tuple<Double>>())
printfn "The values sorted in descending order:"
for value in values do
printfn $" %A{value.Item1}"
// The example displays the following output:
// The values in unsorted order:
// 13.54
// NaN
// -189.42993
// Infinity
// 4.94065645841247E-324
// 1.934E-17
// -Infinity
// -3.588E-12
//
// The values sorted in descending order:
// Infinity
// 13.54
// 1.934E-17
// 4.94065645841247E-324
// -3.588E-12
// -189.42993
// -Infinity
// NaN
Imports System.Collections.Generic
Public Class DescendingComparer(Of T) : Implements IComparer(Of T)
Public Function Compare(ByVal x As T, ByVal y As T) As Integer Implements IComparer(Of T).Compare
Return -1 * Comparer(Of T).Default.Compare(x, y)
End Function
End Class
Module Example
Sub Main()
Dim values() = { Tuple.Create(13.54),
Tuple.Create(Double.NaN),
Tuple.Create(-189.42993),
Tuple.Create(Double.PositiveInfinity),
Tuple.Create(Double.Epsilon),
Tuple.Create(1.934E-17),
Tuple.Create(Double.NegativeInfinity),
Tuple.Create(-0.000000000003588),
Nothing}
Console.WriteLine("The values in unsorted order:")
For Each value As Tuple(Of Double) In values
If value IsNot Nothing Then
Console.WriteLine(" {0}", value.Item1)
Else
Console.WriteLine(" <null>")
End If
Next
Console.WriteLine()
Array.Sort(values, New DescendingComparer(Of Tuple(Of Double)))
Console.WriteLine("The values sorted in descending order:")
For Each value As Tuple(Of Double) In values
If value IsNot Nothing Then
Console.WriteLine(" {0}", value.Item1)
Else
Console.WriteLine(" <null>")
End If
Next
End Sub
End Module
' The example displays the following output:
' The values in unsorted order:
' 13.54
' NaN
' -189.42993
' Infinity
' 4.94065645841247E-324
' 1.934E-17
' -Infinity
' -3.588E-12
'
' The values sorted in descending order:
' Infinity
' 13.54
' 1.934E-17
' 4.94065645841247E-324
' -3.588E-12
' -189.42993
' -Infinity
' NaN
Hinweise
Obwohl diese Methode direkt aufgerufen werden kann, wird sie am häufigsten von Sammlungssortiermethoden aufgerufen, die Parameter enthalten IComparer , um die Elemente einer Auflistung zu ordnen. Sie wird beispielsweise von der Array.Sort(Array, IComparer) Methode und der Add Methode eines SortedList Objekts aufgerufen, das mithilfe des SortedList.SortedList(IComparer) Konstruktors instanziiert wird.
Vorsicht
Die IStructuralComparable.CompareTo Methode ist für sortiervorgänge vorgesehen. Es sollte nicht verwendet werden, wenn der Hauptzweck eines Vergleichs darin besteht, zu bestimmen, ob zwei Objekte gleich sind. Um zu bestimmen, ob zwei Objekte gleich sind, rufen Sie die IStructuralEquatable.Equals Methode auf.
