Comparer.Compare(Object, Object) Yöntem

Tanım

Ad Alanı:

System.Collections

Bütünleştirilmiş Kod:

System.Runtime.dll

Kaynak:

Comparer.cs

Aynı türdeki iki nesnenin büyük/küçük harfe duyarlı karşılaştırmasını gerçekleştirir ve birinin diğerinden küçük, ona eşit veya ondan büyük olduğunu belirten bir değer döndürür.

public:
 virtual int Compare(System::Object ^ a, System::Object ^ b);

public int Compare (object? a, object? b);

abstract member Compare : obj * obj -> int
override this.Compare : obj * obj -> int

Public Function Compare (a As Object, b As Object) As Integer

Parametreler

a

Object

Karşılaştırma yapılacak ilk nesne.

b

Object

Karşılaştırma yapılacak ikinci nesne.

Döndürülenler

Int32

Aşağıdaki tabloda gösterildiği gibi ve bgöreli değerlerini gösteren imzalı bir tamsayıa.

Değer	Anlamı
Sıfırdan küçük	a değerinden küçüktür b.
Sıfır	abeşittir.
Sıfırdan büyük	a değerinden büyüktür b.

Uygulamalar

Compare(Object, Object)

Özel durumlar

ArgumentException

Arabirimi ne uygular IComparable ne de ab uygular.

-veya-

a ve b farklı türlerdedir ve ikisi de diğeriyle karşılaştırmaları işleyebilir.

Örnekler

Aşağıdaki kod örneği, ile Comparerilişkili kültüre bağlı olarak farklı değerlerin nasıl Compare döndürüldüğü gösterir.

using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
   
   // Creates the strings to compare.
   String^ str1 = "llegar";
   String^ str2 = "lugar";
   Console::WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 );
   
   // Uses the DefaultInvariant Comparer.
   Console::WriteLine( "   Invariant Comparer: {0}", Comparer::DefaultInvariant->Compare( str1, str2 ) );
   
   // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
   Comparer^ myCompIntl = gcnew Comparer( gcnew CultureInfo(  "es-ES",false ) );
   Console::WriteLine( "   International Sort: {0}", myCompIntl->Compare( str1, str2 ) );
   
   // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
   Comparer^ myCompTrad = gcnew Comparer( gcnew CultureInfo( 0x040A,false ) );
   Console::WriteLine( "   Traditional Sort  : {0}", myCompTrad->Compare( str1, str2 ) );
}

/*
This code produces the following output.

Comparing "llegar" and "lugar" ...
   Invariant Comparer: -1
   International Sort: -1
   Traditional Sort  : 1

*/

using System;
using System.Collections;
using System.Globalization;

public class SamplesComparer  {

   public static void Main()  {

      // Creates the strings to compare.
      String str1 = "llegar";
      String str2 = "lugar";
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 );

      // Uses the DefaultInvariant Comparer.
      Console.WriteLine( "   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Comparer myCompIntl = new Comparer( new CultureInfo( "es-ES", false ) );
      Console.WriteLine( "   International Sort: {0}", myCompIntl.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Comparer myCompTrad = new Comparer( new CultureInfo( 0x040A, false ) );
      Console.WriteLine( "   Traditional Sort  : {0}", myCompTrad.Compare( str1, str2 ) );
   }
}

/*
This code produces the following output.

Comparing "llegar" and "lugar" ...
   Invariant Comparer: -1
   International Sort: -1
   Traditional Sort  : 1

*/

Imports System.Collections
Imports System.Globalization

Public Class SamplesComparer

   Public Shared Sub Main()

      ' Creates the strings to compare.
      Dim str1 As [String] = "llegar"
      Dim str2 As [String] = "lugar"
      Console.WriteLine("Comparing ""{0}"" and ""{1}"" ...", str1, str2)

      ' Uses the DefaultInvariant Comparer.
      Console.WriteLine("   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare(str1, str2))

      ' Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Dim myCompIntl As New Comparer(New CultureInfo("es-ES", False))
      Console.WriteLine("   International Sort: {0}", myCompIntl.Compare(str1, str2))

      ' Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Dim myCompTrad As New Comparer(New CultureInfo(&H40A, False))
      Console.WriteLine("   Traditional Sort  : {0}", myCompTrad.Compare(str1, str2))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "llegar" and "lugar" ...
'   Invariant Comparer: -1
'   International Sort: -1
'   Traditional Sort  : 1

Açıklamalar

uygularsa aIComparable, ardından a. CompareTo(b) döndürülür; aksi takdirde, uygularsa IComparableb öğesinin olumsuzlanan sonucu olurb. CompareTo (a) döndürülür.

Herhangi bir türle karşılaştırmaya null izin verilir ve kullanırken IComparableözel durum oluşturmaz. Sıralama sırasında, null diğer nesnelerden daha küçük olarak kabul edilir.

Dize karşılaştırmaları kültüre bağlı olarak farklı sonuçlara sahip olabilir. Kültüre özgü karşılaştırmalar hakkında daha fazla bilgi için ad alanına ve Genelleştirme ve Yerelleştirme'ye bakınSystem.Globalization.

Ayrıca bkz.

• IComparable
• CompareInfo
• CurrentCulture
• CultureInfo