Freigeben über


IComparer.Compare-Methode

Vergleicht zwei Objekte und zeigt über den zurückgegebenen Wert an, ob eines der Objekte kleiner, gleich oder größer als das andere Objekt ist.

Namespace: System.Collections
Assembly: mscorlib (in mscorlib.dll)

Syntax

'Declaration
Function Compare ( _
    x As Object, _
    y As Object _
) As Integer
'Usage
Dim instance As IComparer
Dim x As Object
Dim y As Object
Dim returnValue As Integer

returnValue = instance.Compare(x, y)
int Compare (
    Object x,
    Object y
)
int Compare (
    Object^ x, 
    Object^ y
)
int Compare (
    Object x, 
    Object y
)
function Compare (
    x : Object, 
    y : Object
) : int

Parameter

  • x
    Das erste zu vergleichende Objekt.
  • y
    Das zweite zu vergleichende Objekt.

Rückgabewert

Wert

Bedingung

Kleiner als 0

x ist kleiner als y.

0

x ist gleich y.

Größer als 0

x ist größer als y.

Ausnahmen

Ausnahmetyp Bedingung

ArgumentException

Weder x noch y implementieren die IComparable-Schnittstelle.

– oder –

x und y sind nicht vom gleichen Typ. Keines der beiden kann einen Vergleich mit dem jeweils anderen Objekt behandeln.

Hinweise

Es wird empfohlen, bei der Implementierung die CompareTo-Methode eines der Parameter zu verwenden.

Ein Vergleich von NULL (Nothing in Visual Basic) mit einem beliebigen Typ ist zulässig und generiert beim Verwenden von IComparable keine Ausnahme. Beim Sortieren ist NULL (Nothing in Visual Basic) kleiner als jedes andere Objekt.

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0, 1.0

Siehe auch

Referenz

IComparer-Schnittstelle
IComparer-Member
System.Collections-Namespace
IComparable-Schnittstelle
Thread.CurrentCulture
System.Globalization.CompareInfo
System.Globalization.CultureInfo