Int64.CompareTo Yöntem

Tanım

Ad Alanı:

System

Bütünleştirilmiş Kod:

System.Runtime.dll

Bütünleştirilmiş Kod:

netstandard.dll

Bütünleştirilmiş Kod:

mscorlib.dll

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

Aşırı Yüklemeler

CompareTo(Int64)	Bu örneği belirtilen 64 bitlik imzalı tamsayıyla karşılar ve göreli değerlerinin bir göstergesini döndürür.
CompareTo(Object)	Bu örneği belirtilen nesne ile karşılaştırır ve göreli değerlerin bir göstergesini döndürür.

CompareTo(Int64)

Bu örneği belirtilen 64 bitlik imzalı tamsayıyla karşılar ve göreli değerlerinin bir göstergesini döndürür.

C#

public int CompareTo (long value);

Parametreler

value

Int64

Karşılaştırmak için bir tamsayı.

Döndürülenler

Int32

Bu ve örneğin göreli değerlerini gösteren imzalı bir value sayı.

Dönüş Değeri	Description
Sıfırdan küçük	Bu örnek, 'den value küçük.
Sıfır	Bu örnek ile value eşittir.
Sıfırdan büyük	Bu örnek, 'den value büyüktür.

Uygulamalar

CompareTo(T)

Örnekler

Aşağıdaki kod örneği, çeşitli değer ve başvuru türleri için yönteminin genel CompareTo ve genel olmayan sürümlerini gösterir.

C#

// This example demonstrates the generic and non-generic versions of the
// CompareTo method for several base types.
// The non-generic version takes a parameter of type Object, while the generic
// version takes a type-specific parameter, such as Boolean, Int32, or Double.

using System;

class Sample
{
    public static void Main()
    {
    string    nl = Environment.NewLine;
    string    msg = "{0}The following is the result of using the generic and non-generic{0}" +
                    "versions of the CompareTo method for several base types:{0}";

    DateTime  now = DateTime.Now;
// Time span = 11 days, 22 hours, 33 minutes, 44 seconds
    TimeSpan  tsX = new TimeSpan(11, 22, 33, 44);
// Version = 1.2.333.4
    Version   versX = new Version("1.2.333.4");
// Guid = CA761232-ED42-11CE-BACD-00AA0057B223
    Guid      guidX = new Guid("{CA761232-ED42-11CE-BACD-00AA0057B223}");

    Boolean  a1 = true,  a2 = true;
    Byte     b1 = 1,     b2 = 1;
    Int16    c1 = -2,    c2 = 2;
    Int32    d1 = 3,     d2 = 3;
    Int64    e1 = 4,     e2 = -4;
    Decimal  f1 = -5.5m, f2 = 5.5m;
    Single   g1 = 6.6f,  g2 = 6.6f;
    Double   h1 = 7.7d,  h2 = -7.7d;
    Char     i1 = 'A',   i2 = 'A';
    String   j1 = "abc", j2 = "abc";
    DateTime k1 = now,   k2 = now;
    TimeSpan l1 = tsX,   l2 = tsX;
    Version  m1 = versX, m2 = new Version("2.0");
    Guid     n1 = guidX, n2 = guidX;

// The following types are not CLS-compliant.
    SByte    w1 = 8,     w2 = 8;
    UInt16   x1 = 9,     x2 = 9;
    UInt32   y1 = 10,    y2 = 10;
    UInt64   z1 = 11,    z2 = 11;
//
    Console.WriteLine(msg, nl);
    try
        {
// The second and third Show method call parameters are automatically boxed because
// the second and third Show method declaration arguments expect type Object.

        Show("Boolean:  ", a1, a2, a1.CompareTo(a2), a1.CompareTo((Object)a2));
        Show("Byte:     ", b1, b2, b1.CompareTo(b2), b1.CompareTo((Object)b2));
        Show("Int16:    ", c1, c2, c1.CompareTo(c2), c1.CompareTo((Object)c2));
        Show("Int32:    ", d1, d2, d1.CompareTo(d2), d1.CompareTo((Object)d2));
        Show("Int64:    ", e1, e2, e1.CompareTo(e2), e1.CompareTo((Object)e2));
        Show("Decimal:  ", f1, f2, f1.CompareTo(f2), f1.CompareTo((Object)f2));
        Show("Single:   ", g1, g2, g1.CompareTo(g2), g1.CompareTo((Object)g2));
        Show("Double:   ", h1, h2, h1.CompareTo(h2), h1.CompareTo((Object)h2));
        Show("Char:     ", i1, i2, i1.CompareTo(i2), i1.CompareTo((Object)i2));
        Show("String:   ", j1, j2, j1.CompareTo(j2), j1.CompareTo((Object)j2));
        Show("DateTime: ", k1, k2, k1.CompareTo(k2), k1.CompareTo((Object)k2));
        Show("TimeSpan: ", l1, l2, l1.CompareTo(l2), l1.CompareTo((Object)l2));
        Show("Version:  ", m1, m2, m1.CompareTo(m2), m1.CompareTo((Object)m2));
        Show("Guid:     ", n1, n2, n1.CompareTo(n2), n1.CompareTo((Object)n2));
//
        Console.WriteLine("{0}The following types are not CLS-compliant:", nl);
        Show("SByte:    ", w1, w2, w1.CompareTo(w2), w1.CompareTo((Object)w2));
        Show("UInt16:   ", x1, x2, x1.CompareTo(x2), x1.CompareTo((Object)x2));
        Show("UInt32:   ", y1, y2, y1.CompareTo(y2), y1.CompareTo((Object)y2));
        Show("UInt64:   ", z1, z2, z1.CompareTo(z2), z1.CompareTo((Object)z2));
        }
    catch (Exception e)
        {
        Console.WriteLine(e);
        }
    }

    public static void Show(string caption, Object var1, Object var2,
                            int resultGeneric, int resultNonGeneric)
    {
    string relation;

    Console.Write(caption);
    if (resultGeneric == resultNonGeneric)
        {
        if      (resultGeneric < 0) relation = "less than";
        else if (resultGeneric > 0) relation = "greater than";
        else                        relation = "equal to";
        Console.WriteLine("{0} is {1} {2}", var1, relation, var2);
        }

// The following condition will never occur because the generic and non-generic
// CompareTo methods are equivalent.

    else
        {
        Console.WriteLine("Generic CompareTo = {0}; non-generic CompareTo = {1}",
                           resultGeneric, resultNonGeneric);
        }
   }
}
/*
This example produces the following results:

The following is the result of using the generic and non-generic versions of the
CompareTo method for several base types:

Boolean:  True is equal to True
Byte:     1 is equal to 1
Int16:    -2 is less than 2
Int32:    3 is equal to 3
Int64:    4 is greater than -4
Decimal:  -5.5 is less than 5.5
Single:   6.6 is equal to 6.6
Double:   7.7 is greater than -7.7
Char:     A is equal to A
String:   abc is equal to abc
DateTime: 12/1/2003 5:37:46 PM is equal to 12/1/2003 5:37:46 PM
TimeSpan: 11.22:33:44 is equal to 11.22:33:44
Version:  1.2.333.4 is less than 2.0
Guid:     ca761232-ed42-11ce-bacd-00aa0057b223 is equal to ca761232-ed42-11ce-bacd-00
aa0057b223

The following types are not CLS-compliant:
SByte:    8 is equal to 8
UInt16:   9 is equal to 9
UInt32:   10 is equal to 10
UInt64:   11 is equal to 11
*/

Açıklamalar

Bu yöntem arabirimini gerçekleştirir ve parametresini bir nesneye dönüştürmesi gerekmesi nedeniyle yöntemden System.IComparable<T> biraz daha iyi performans Int64.CompareTo value gösterir.

Programlama dilinize bağlı olarak parametre türünün örnek türünden daha az bit (daha dar) olduğu bir yöntem CompareTo kodlamanız mümkün olabilir. Bazı programlama dilleri parametreyi bitler örnek kadar çokmuş gibi bir tür olarak temsil eden dolaylı bir genişletme dönüşümü gerçekleştirdiği için bu olasıdır.

Örneğin, örnek türünün ve parametre Int32 türünün olduğunu Byte varsayalım. Microsoft C# derleyicisi parametrenin değerini bir nesne olarak temsil etmek için yönergeler oluşturur, ardından örneğin değerlerini ve parametre gösterimini karşılaştıran Int32 Int32.CompareTo bir yöntem Int32 Int32 oluşturur.

Derleyicinin sayısal türlerde örtülü genişleme dönüştürmeleri gerçekleştirip gerçekleştirmediğini belirlemek için programlama dilinizle ilgili belgelere bakın.

Ayrıca bkz.

• UInt64
• Equals(Object)

CompareTo(Object)

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

C#

public int CompareTo (object? value);

C#

public int CompareTo (object value);

Parametreler

value

Object

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

Döndürülenler

Int32

Bu ve örneğin göreli değerlerini gösteren imzalı bir value sayı.

Dönüş Değeri	Description
Sıfırdan küçük	Bu örnek, 'den value küçük.
Sıfır	Bu örnek ile value eşittir.
Sıfırdan büyük	Bu örnek , veya value 'den value null büyüktür.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

value bir Int64 değildir.

Açıklamalar

Değerinden Int64 bağımsız olarak bir , null başvurudan büyük olarak kabul edilir.

parametresi value veya null örneği Int64 olmalıdır; aksi takdirde bir özel durum oluşturur.

Ayrıca bkz.

• UInt64
• Equals(Object)