Boolean.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 nesne veya nesneyle Boolean karşılar ve kendi ilişkilerini gösteren bir tamsayı döndürür.

Aşırı Yüklemeler

CompareTo(Boolean)	Bu örneği belirtilen bir nesneyle Boolean karşılar ve kendi ilişkilerini gösteren bir tamsayı döndürür.
CompareTo(Object)	Bu örneği belirtilen bir nesneyle karşılar ve kendi ilişkilerini gösteren bir tamsayı döndürür.

CompareTo(Boolean)

Bu örneği belirtilen bir nesneyle Boolean karşılar ve kendi ilişkilerini gösteren bir tamsayı döndürür.

C#

public int CompareTo (bool value);

Parametreler

value

Boolean

Bu Boolean örnekle karşılaştıran bir nesne.

Döndürülenler

Int32

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

Dönüş Değeri	Koşul
Sıfırdan küçük	Bu örnek ve false value true olur.
Sıfır	Bu örnek ve value eşittir (ikisi de veya true her ikisi de false olur).
Sıfırdan büyük	Bu örnek ve true value false olur.

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 Boolean.CompareTo value gösterir.

Örnek türünden daha az bit varsa (daha darsa), bazı programlama dilleri parametrenin değerini daha fazla bite sahip bir değere dönüştüren örtülü bir genişle dönüştürme value işlemi gerçekleştirin.

Ö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ği ve parametre gösterimini karşılaştırmak Int32 Int32.CompareTo için bir yöntem 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.

• CompareTo(Object)
• Equals

CompareTo(Object)

Bu örneği belirtilen bir nesneyle karşılar ve kendi ilişkilerini gösteren bir tamsayı döndürür.

C#

public int CompareTo (object? obj);

C#

public int CompareTo (object obj);

Parametreler

obj

Object

Bu örnekle karşılaştıran bir nesne veya null .

Döndürülenler

Int32

Bu örneğin ve göreli sıralamayı gösteren imzalı bir obj tamsayı.

Dönüş Değeri	Koşul
Sıfırdan küçük	Bu örnek ve false obj true olur.
Sıfır	Bu örnek ve obj eşittir (ikisi de veya true her ikisi de false olur).
Sıfırdan büyük	Bu örnek ve true obj false olur. -veya- obj, null değeridir.

Uygulamalar

CompareTo(Object)

Özel durumlar

ArgumentException

obj bir Boolean değildir.

Açıklamalar

obj veya null örneği olması Boolean gerekir; aksi takdirde bir özel durum oluşturur.

Bu yöntem IComparable arabirimini kullanır.

Ayrıca bkz.

• CompareTo(Boolean)
• Equals