Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Int32.CompareTo-Methode: (Int32)

 

Veröffentlicht: Oktober 2016

Vergleicht diese Instanz mit einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.

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

public int CompareTo(
	int value
)

Parameter

value
Type: System.Int32

Eine zu vergleichende Ganzzahl.

Rückgabewert

Type: System.Int32

Eine Zahl mit Vorzeichen, die das Verhältnis zwischen dem Wert dieser Instanz und value angibt.

Rückgabewert

Beschreibung

Kleiner als 0 (Null)

Diese Instanz ist kleiner als value.

0 (Null)

Diese Instanz ist gleich value.

Größer als 0 (Null)

Diese Instanz ist größer als value.

Diese Methode implementiert die System.IComparable<T> Schnittstelle und führt etwas bessere Leistung als die Int32.CompareTo Methode, da sie keinen konvertieren die value Parameter für ein Objekt.

Abhängig von der Programmiersprache, ist es eventuell möglich, Code eine CompareTo Methode, in dem der Parametertyp weniger Bits aufweist (schmaler ist) als der Instanztyp. Dies ist möglich, da einige Programmiersprachen eine implizite erweiternde Konvertierung durchführt, die den Parameter als einen Typ mit wie vielen Bits wie die Instanz darstellt.

Nehmen wir beispielsweise an, die der Typ ist Int32 und der Parametertyp ist Byte. Microsoft C#-Compiler generiert Anweisungen, um die Darstellung des Werts des Parameters als ein Int32, generiert dann eine Int32.CompareTo Methode, die die Werte der vergleicht die Int32 Instanz und die Int32 Parameter Darstellung.

Ihre Programmiersprache Dokumentation, um festzustellen, ob der Compiler implizite erweiternde Konvertierungen für numerische Typen ausführt.

Das folgende Beispiel veranschaulicht die Int32.CompareTo(Int32) Methode. Zusätzlich zur Anzeige der von der Methode für vier verschiedene Vergleiche zurückgegebenen Wert, den Rückgabewert auf einen Member der benutzerdefinierten konvertiert Comparison Enumeration, deren Wert werden angezeigt.

using System;

enum Comparison {
   LessThan=-1, Equal=0, GreaterThan=1};

public class ValueComparison
{
   public static void Main()
   {
      int mainValue = 16325;
      int zeroValue = 0;
      int negativeValue = -1934;
      int positiveValue = 903624;
      int sameValue = 16325;

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",  
                        mainValue, zeroValue, 
                        mainValue.CompareTo(zeroValue), 
                        (Comparison) mainValue.CompareTo(zeroValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).",
                        mainValue, sameValue, 
                        mainValue.CompareTo(sameValue), 
                        (Comparison) mainValue.CompareTo(sameValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", 
                        mainValue, negativeValue, 
                        mainValue.CompareTo(negativeValue), 
                        (Comparison) mainValue.CompareTo(negativeValue));

      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", 
                        mainValue, positiveValue, 
                        mainValue.CompareTo(positiveValue), 
                        (Comparison) mainValue.CompareTo(positiveValue));
   }
}
// The example displays the following output:
//       Comparing 16325 and 0: 1 (GreaterThan).
//       Comparing 16325 and 16325: 0 (Equal).
//       Comparing 16325 and -1934: 1 (GreaterThan).
//       Comparing 16325 and 903624: -1 (LessThan).

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 2.0
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Silverlight
Verfügbar seit 2.0
Windows Phone Silverlight
Verfügbar seit 7.0
Windows Phone
Verfügbar seit 8.1
Zurück zum Anfang
Anzeigen: