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 zum Anzeigen des von der-Methode zurückgegebenen Werts für vier verschiedene Vergleiche wird der Rückgabewert in einen Member der benutzerdefinierten Comparison Enumeration konvertiert, dessen Wert auch angezeigt wird.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 eine etwas Int32.CompareTo bessere Leistung als die-Methode aus, da value der-Parameter nicht in ein-Objekt konvertiert werden muss.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 ihrer Programmiersprache kann es möglich sein, eine CompareTo Methode zu codieren, bei der der Parametertyp weniger Bits (ist schmaler) als der Instanztyp aufweist.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, weil einige Programmiersprachen eine implizite erweiternde Konvertierung durchführen, die den Parameter als Typ mit so vielen Bits wie 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.

Angenommen, der Instanztyp ist Int32 , und der Parametertyp ist. ByteFor example, suppose the instance type is Int32 and the parameter type is Byte. Der Microsoft C# -Compiler generiert Anweisungen, um den Wert des-Parameters Int32als darzustellen, und Int32.CompareTo generiert dann eine- Int32 Methode, die die Werte der Int32 -Instanz und des-Parameters vergleicht. tungs.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.

Überprüfen Sie anhand der Dokumentation der Programmiersprache, ob der Compiler implizite erweiternde Konvertierungen für numerische Typen durchfü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 Int32gilt unabhängig von ihrem Wert als größer als. nullAny instance of Int32, regardless of its value, is considered greater than null.

valuemuss oder null eine Instanz von Int32sein, 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: