Int32.CompareTo Int32.CompareTo Int32.CompareTo Int32.CompareTo Method

Definition

Vergleicht diese Instanz mit einem angegebenen Objekt oder Int32 und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified object or Int32 and returns an indication of their relative values.

Überlädt

CompareTo(Int32) CompareTo(Int32) CompareTo(Int32) CompareTo(Int32)

Vergleicht diese Instanz mit einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified 32-bit signed integer and returns an indication of their relative values.

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified object and returns an indication of their relative values.

CompareTo(Int32) CompareTo(Int32) CompareTo(Int32) CompareTo(Int32)

Vergleicht diese Instanz mit einer angegebenen 32-Bit-Ganzzahl mit Vorzeichen und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified 32-bit signed integer and returns an indication of their relative values.

public:
 virtual int CompareTo(int value);
public int CompareTo (int value);
abstract member CompareTo : int -> int
override this.CompareTo : int -> int
Public Function CompareTo (value As Integer) As Integer

Parameter

value
Int32 Int32 Int32 Int32

Eine zu vergleichende Ganzzahl.An integer to compare.

Gibt zurück

Eine Zahl mit Vorzeichen, die das Verhältnis zwischen dem Wert dieser Instanz und value angibt.A signed number indicating the relative values of this instance and value.

RückgabewertReturn Value BESCHREIBUNGDescription
Kleiner als 0 (null)Less than zero Diese Instanz ist kleiner als value.This instance is less than value.
ZeroZero Diese Instanz ist gleich value.This instance is equal to value.
Größer als 0 (null)Greater than zero Diese Instanz ist größer als value.This instance is greater than value.

Implementiert

Beispiele

Das folgende Beispiel veranschaulicht die Int32.CompareTo(Int32) Methode.The following example demonstrates the Int32.CompareTo(Int32) method. Zusätzlich zur Anzeige des Rückgabewert von der Methode für vier verschiedene Vergleiche, konvertiert es den Rückgabewert auf einen Member der benutzerdefinierten Comparison -Enumeration, deren Wert, der es auch zeigt.In addition to displaying the value returned by the method for four different comparisons, it converts the return value to a member of the custom Comparison enumeration, whose value it also displays.

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).
Public Enum Comparison As Integer
   LessThan = -1
   Equal = 0
   GreaterThan = 1
End Enum

Module ValueComparison
   Public Sub Main()
      Dim mainValue As Integer = 16325
      Dim zeroValue As Integer = 0
      Dim negativeValue As Integer = -1934
      Dim positiveValue As Integer = 903624
      Dim sameValue As Integer = 16325
      
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, zeroValue, _
                        mainValue.CompareTo(zeroValue), _
                        CType(mainValue.CompareTo(zeroValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, sameValue, _
                        mainValue.CompareTo(sameValue), _
                        CType(mainValue.CompareTo(sameValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, negativeValue, _
                        mainValue.CompareTo(negativeValue), _
                        CType(mainValue.CompareTo(negativeValue), Comparison))
                        
      Console.WriteLine("Comparing {0} and {1}: {2} ({3}).", _ 
                        mainValue, positiveValue, _
                        mainValue.CompareTo(positiveValue), _
                        CType(mainValue.CompareTo(positiveValue), Comparison))
   End Sub
End Module
' 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).

Hinweise

Diese Methode implementiert die System.IComparable<T> -Schnittstelle und führt etwas bessere Leistung als die Int32.CompareTo Methode, da es keine konvertieren die value Parameter für ein Objekt.This method implements the System.IComparable<T> interface and performs slightly better than the Int32.CompareTo method because it does not have to convert the value parameter to an object.

Abhängig von der Programmiersprache, ist es eventuell möglich, Code eine CompareTo Methode, bei der Parametertyp weniger Bits hat (schmaler ist) als der Instanztyp.Depending on your programming language, it might be possible to code a CompareTo method where the parameter type has fewer bits (is narrower) than the instance type. Dies ist möglich, da einige Programmiersprachen eine implizite erweiternde Konvertierung durchführen, die den Parameter als einen Typ mit wie vielen Bits als die Instanz darstellt.This is possible because some programming languages perform an implicit widening conversion that represents the parameter as a type with as many bits as the instance.

Nehmen wir beispielsweise an, der Instanztyp Int32 und der Parametertyp ist Byte.For example, suppose the instance type is Int32 and the parameter type is Byte. Der Microsoft C#-Compiler generiert, Anweisungen, um den Wert des Parameters als darstellen ein Int32, generiert dann eine Int32.CompareTo -Methode, die die Werte der vergleicht die Int32 Instanz und die Int32 Darstellung der Parameter.The Microsoft C# compiler generates instructions to represent the value of the parameter as an Int32, then generates a Int32.CompareTo method that compares the values of the Int32 instance and the Int32 parameter representation.

Ihre bevorzugte Programmiersprache Dokumentation, um festzustellen, ob der Compiler implizite erweiternde Konvertierungen für numerische Typen ausführt.Consult your programming language's documentation to determine whether its compiler performs implicit widening conversions on numeric types.

Siehe auch

CompareTo(Object) CompareTo(Object) CompareTo(Object) CompareTo(Object)

Vergleicht diese Instanz mit einem angegebenen Objekt und gibt eine Angabe über das Verhältnis der entsprechenden Werte zurück.Compares this instance to a specified object and returns an indication of their relative values.

public:
 virtual int CompareTo(System::Object ^ value);
public int CompareTo (object value);
abstract member CompareTo : obj -> int
override this.CompareTo : obj -> int
Public Function CompareTo (value As Object) As Integer

Parameter

value
Object Object Object Object

Ein Vergleichsobjekt oder null.An object to compare, or null.

Gibt zurück

Eine Zahl mit Vorzeichen, die das Verhältnis zwischen dem Wert dieser Instanz und value angibt.A signed number indicating the relative values of this instance and value.

RückgabewertReturn Value BESCHREIBUNGDescription
Kleiner als 0 (null)Less than zero Diese Instanz ist kleiner als value.This instance is less than value.
ZeroZero Diese Instanz ist gleich value.This instance is equal to value.
Größer als 0 (null)Greater than zero Diese Instanz ist größer als value.This instance is greater than value. - oder --or- value ist null.value is null.

Implementiert

Ausnahmen

Hinweise

Jede Instanz von Int32, unabhängig von seinem Wert wird als größer betrachtet null.Any instance of Int32, regardless of its value, is considered greater than null.

value muss null oder eine Instanz von Int32ist, andernfalls wird eine Ausnahme ausgelöst.value must be null or an instance of Int32; otherwise, an exception is thrown.

Siehe auch

Gilt für: