Прочитать на английском

Поделиться через


CompareInfo.GetCompareInfo Метод

Определение

Инициализирует новый объект CompareInfo.

Перегрузки

GetCompareInfo(Int32)

Инициализирует новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором.

GetCompareInfo(String)

Инициализирует новый объект CompareInfo, связанный с языком и региональными параметрами с заданным именем.

GetCompareInfo(Int32, Assembly)

Инициализирует новый объект CompareInfo, связанный с указанным языком и региональными параметрами и использующий методы сравнения строк в указанном объекте Assembly.

GetCompareInfo(String, Assembly)

Инициализирует новый объект CompareInfo, связанный с указанным языком и региональными параметрами и использующий методы сравнения строк в указанном объекте Assembly.

GetCompareInfo(Int32)

Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs

Инициализирует новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором.

public static System.Globalization.CompareInfo GetCompareInfo (int culture);

Параметры

culture
Int32

Целое число, представляющее идентификатор языка и региональных параметров.

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

Новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором и использующий методы сравнения строк в текущем объекте Assembly.

Примеры

В следующем примере сравниваются части двух строк с использованием разных CompareInfo объектов :

  • CompareInfo Объект, связанный с языком и региональными параметрами испанского языка (Испания), с международной сортировкой

  • CompareInfo Объект, связанный с языком и региональными параметрами испанского языка (Испания) с традиционной сортировкой

  • CompareInfo объект , связанный с InvariantCulture

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "calor";

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      CompareInfo myCompIntl = CompareInfo.GetCompareInfo( "es-ES" );

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      CompareInfo myCompTrad = CompareInfo.GetCompareInfo( 0x040A );

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myCompInva = CultureInfo.InvariantCulture.CompareInfo;

      // Compares two strings using myCompIntl.
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
      Console.WriteLine( "   With myCompIntl.Compare: {0}", myCompIntl.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompTrad.Compare: {0}", myCompTrad.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompInva.Compare: {0}", myCompInva.Compare( myStr1, myStr2 ) );
   }
}


/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl.Compare: -1
   With myCompTrad.Compare: 1
   With myCompInva.Compare: -1

*/

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetCompareInfo(String)

Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs

Инициализирует новый объект CompareInfo, связанный с языком и региональными параметрами с заданным именем.

public static System.Globalization.CompareInfo GetCompareInfo (string name);

Параметры

name
String

Строка, представляющая имя языка и региональных параметров.

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

Новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором и использующий методы сравнения строк в текущем объекте Assembly.

Исключения

name имеет значение null.

Значение параметра name не является допустимым именем языка и региональных параметров.

Примеры

В следующем примере сравниваются части двух строк с использованием разных CompareInfo объектов :

  • CompareInfo Объект, связанный с языком и региональными параметрами испанского языка (Испания), с международной сортировкой

  • CompareInfo Объект, связанный с языком и региональными параметрами испанского языка (Испания) с традиционной сортировкой

  • CompareInfo объект , связанный с InvariantCulture

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the "Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the "Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.

using System;
using System.Globalization;

public class SamplesCompareInfo  {

   public static void Main()  {

      // Defines the strings to compare.
      String myStr1 = "calle";
      String myStr2 = "calor";

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with international sort.
      CompareInfo myCompIntl = CompareInfo.GetCompareInfo( "es-ES" );

      // Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      CompareInfo myCompTrad = CompareInfo.GetCompareInfo( 0x040A );

      // Uses the CompareInfo property of the InvariantCulture.
      CompareInfo myCompInva = CultureInfo.InvariantCulture.CompareInfo;

      // Compares two strings using myCompIntl.
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\"", myStr1, myStr2 );
      Console.WriteLine( "   With myCompIntl.Compare: {0}", myCompIntl.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompTrad.Compare: {0}", myCompTrad.Compare( myStr1, myStr2 ) );
      Console.WriteLine( "   With myCompInva.Compare: {0}", myCompInva.Compare( myStr1, myStr2 ) );
   }
}


/*
This code produces the following output.

Comparing "calle" and "calor"
   With myCompIntl.Compare: -1
   With myCompTrad.Compare: 1
   With myCompInva.Compare: -1

*/

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

.NET 9 и другие версии
Продукт Версии
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

GetCompareInfo(Int32, Assembly)

Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs

Инициализирует новый объект CompareInfo, связанный с указанным языком и региональными параметрами и использующий методы сравнения строк в указанном объекте Assembly.

public static System.Globalization.CompareInfo GetCompareInfo (int culture, System.Reflection.Assembly assembly);

Параметры

culture
Int32

Целое число, представляющее идентификатор языка и региональных параметров.

assembly
Assembly

Класс Assembly, содержащий используемые методы сравнения строк.

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

Новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором и использующий методы сравнения строк в текущем объекте Assembly.

Исключения

assembly имеет значение null.

Параметр assembly относится к недопустимому типу.

Комментарии

Примечание

Поведение этого метода непредсказуемо. Для приложения рекомендуется использовать версию этого метода, которая не принимает входные данные сборки.

Параметр assembly должен иметь тот же тип, что и Module.Assembly.

См. также раздел

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

GetCompareInfo(String, Assembly)

Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs
Исходный код:
CompareInfo.cs

Инициализирует новый объект CompareInfo, связанный с указанным языком и региональными параметрами и использующий методы сравнения строк в указанном объекте Assembly.

public static System.Globalization.CompareInfo GetCompareInfo (string name, System.Reflection.Assembly assembly);

Параметры

name
String

Строка, представляющая имя языка и региональных параметров.

assembly
Assembly

Класс Assembly, содержащий используемые методы сравнения строк.

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

Новый объект CompareInfo, связанный с языком и региональными параметрами с заданным идентификатором и использующий методы сравнения строк в текущем объекте Assembly.

Исключения

name имеет значение null.

-или-

assembly имеет значение null.

Значение параметра name не является допустимым именем языка и региональных параметров.

-или-

Параметр assembly относится к недопустимому типу.

Комментарии

Примечание

Поведение этого метода непредсказуемо. Рекомендуется использовать версию этого метода, которая не принимает входные данные сборки.

Параметр assembly должен иметь тот же тип, что и Module.Assembly.

См. также раздел

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

.NET 9 и другие версии
Продукт Версии
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1