Comparer.Compare(Object, Object) Метод

Определение

Выполняет сравнение двух объектов одного типа с учетом регистра и возвращает значение, которое показывает, в каком отношении (меньше, равно или больше) находятся два объекта.Performs a case-sensitive comparison of two objects of the same type and returns a value indicating whether one is less than, equal to, or greater than the other.

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

Параметры

a
Object

Первый сравниваемый объект.The first object to compare.

b
Object

Второй сравниваемый объект.The second object to compare.

Возвращаемое значение

Знаковое целое число, которое определяет относительные значения параметров a и b, как показано в следующей таблице.A signed integer that indicates the relative values of a and b, as shown in the following table.

ЗначениеValue ЗначениеMeaning
Меньше нуляLess than zero Значение a меньше b.a is less than b.
НульZero a равняется b.a equals b.
Больше нуляGreater than zero Значение a больше значения b.a is greater than b.

Реализации

Исключения

Ни параметр a, ни параметр b не реализует интерфейс IComparable.Neither a nor b implements the IComparable interface.

-или--or- Параметры a и b имеют разные типы и не могут сравниваться друг с другом.a and b are of different types and neither one can handle comparisons with the other.

Примеры

В следующем примере кода показано, как Compare возвращает различные значения в зависимости от языка и региональных параметров, связанных с Comparer.The following code example shows how Compare returns different values depending on the culture associated with the Comparer.

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 реализует IComparable, то a.If a implements IComparable, then a. возвращается CompareTo (b); в противном случае, если b реализует IComparable, то результат bс противоположным знаком.CompareTo (b) is returned; otherwise, if b implements IComparable, then the negated result of b. возвращается CompareTo (a).CompareTo (a) is returned.

Допускается сравнение null с любым типом и не создает исключение при использовании IComparable.Comparing null with any type is allowed and does not generate an exception when using IComparable. При сортировке null считается меньше, чем любой другой объект.When sorting, null is considered to be less than any other object.

Сравнение строк может иметь разные результаты в зависимости от языка и региональных параметров.String comparisons might have different results depending on the culture. Дополнительные сведения о сравнении в зависимости от языка и региональных параметров см. в разделе System.Globalization пространство имен, Глобализация и локализация.For more information on culture-specific comparisons, see the System.Globalization namespace and Globalization and Localization.

Применяется к

Дополнительно