Int32.CompareTo Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kodlar:

netstandard.dll, System.Runtime.dll

Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

Aşırı Yüklemeler

Name	Description
CompareTo(Int32)	Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.
CompareTo(Object)	Bu örneği belirtilen bir nesneyle karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

CompareTo(Int32)

Kaynak:

Int32.cs

Bu örneği belirtilen 32 bit imzalı tamsayıyla karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

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

Parametreler

value

Int32

Karşılaştıracak bir tamsayı.

Döndürülenler

Int32

Ve bu örneğin valuegöreli değerlerini gösteren imzalı bir sayı.

Dönüş Değeri	Açıklama
Sıfırdan küçük	Bu örnek değerinden valueküçüktür.
Sıfır	Bu örnek eşittir value.
Sıfırdan büyük	Bu örnek değerinden valuebüyüktür.

Uygulamalar

CompareTo(T)

Örnekler

Aşağıdaki örnekte yöntemi gösterilmektedir Int32.CompareTo(Int32) . Yöntemi tarafından dört farklı karşılaştırma için döndürülen değeri görüntülemeye ek olarak, dönüş değerini, değerini de görüntülediği özel Comparison sabit listesi üyesine dönüştürür.

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).

open System

type Comparison =
    | LessThan = -1 
    | Equal = 0
    | GreaterThan = 1

let mainValue = 16325
let zeroValue = 0
let negativeValue = -1934
let positiveValue = 903624
let sameValue = 16325

printfn $"Comparing {mainValue} and {zeroValue}: {mainValue.CompareTo zeroValue} ({enum<Comparison>(mainValue.CompareTo zeroValue)})."

printfn $"Comparing {mainValue} and {sameValue}: {mainValue.CompareTo sameValue} ({enum<Comparison>(mainValue.CompareTo sameValue)})."

printfn $"Comparing {mainValue} and {negativeValue}: {mainValue.CompareTo negativeValue} ({enum<Comparison>(mainValue.CompareTo negativeValue)})." 

printfn $"Comparing {mainValue} and {positiveValue}: {mainValue.CompareTo positiveValue} ({enum<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).

Açıklamalar

Bu yöntem System.IComparable<T> arabirimini uygular ve Int32.CompareTo parametresini bir nesneye dönüştürmesi gerekmediğinden value yönteminden biraz daha iyi performans gösterir.

Programlama dilinize bağlı olarak, parametre türünün örnek türünden daha az bit (daha dar) olduğu bir CompareTo yöntemi kodlayabilirsiniz. Bunun nedeni, bazı programlama dillerinin parametreyi örnek kadar bit içeren bir tür olarak temsil eden örtük bir genişletme dönüştürmesi gerçekleştirmesi olabilir.

Örneğin, örnek türü Int32 ve parametre türü Byte olsun. Microsoft C# derleyicisi parametrenin değerini Int32 olarak göstermek için yönergeler oluşturur, ardından Int32.CompareTo örneğinin ve Int32 parametre gösteriminin değerlerini karşılaştıran bir Int32 yöntemi oluşturur.

Derleyicinin sayısal türlerde örtük genişletme dönüştürmeleri gerçekleştirip gerçekleştirmediğini belirlemek için programlama dilinizin belgelerine bakın.

Ayrıca bkz.

• UInt32
• Equals(Object)

CompareTo(Object)

Kaynak:

Int32.cs

Bu örneği belirtilen bir nesneyle karşılaştırır ve göreli değerlerinin bir göstergesini döndürür.

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

Parametreler

value

Object

Karşılaştıracak bir nesne veya null.

Döndürülenler

Int32

Ve bu örneğin valuegöreli değerlerini gösteren imzalı bir sayı.

Dönüş Değeri	Açıklama
Sıfırdan küçük	Bu örnek değerinden valueküçüktür.
Sıfır	Bu örnek eşittir value.
Sıfırdan büyük	Bu örnek veya valuevaluedeğerinden nullbüyüktür.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

value bir Int32değildir.

Açıklamalar

Int32herhangi bir örneği, değerinden bağımsız olarak nulldeğerinden büyük kabul edilir.

valueveya örneği nullolmalıdırInt32; aksi takdirde bir özel durum oluşturulur.

Ayrıca bkz.

• UInt32
• Equals(Object)