CompareInfo.GetCompareInfo Метод

Определение

Пространство имен:

System.Globalization

Сборка:

System.Runtime.dll

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

Перегрузки

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

GetCompareInfo(Int32)

Исходный код:

CompareInfo.cs

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

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(int culture);

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

static member GetCompareInfo : int -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (culture As Integer) As CompareInfo

Параметры

culture

Int32

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

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

CompareInfo

Новый объект 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 S"Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.
using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the strings to compare.
   String^ myStr1 = "calle";
   String^ myStr2 = "calor";
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with international sort.
   CompareInfo^ myCompIntl = CompareInfo::GetCompareInfo( "es-ES" );
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"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
*/

// 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

*/

' 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.

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "calor"

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

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      Dim myCompTrad As CompareInfo = CompareInfo.GetCompareInfo(&H40A)

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myCompInva As CompareInfo = 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))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "calle" and "calor"
'   With myCompIntl.Compare: -1
'   With myCompTrad.Compare: 1
'   With myCompInva.Compare: -1

GetCompareInfo(String)

Исходный код:

CompareInfo.cs

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

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(System::String ^ name);

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

static member GetCompareInfo : string -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (name As String) As CompareInfo

Параметры

name

String

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

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

CompareInfo

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

Исключения

ArgumentNullException

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

ArgumentException

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

Примеры

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

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

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

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

// The following code example compares two strings using the different CompareInfo instances:
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with international sort,
//    a CompareInfo instance associated with the S"Spanish - Spain" culture with traditional sort, and
//    a CompareInfo instance associated with the InvariantCulture.
using namespace System;
using namespace System::Globalization;
int main()
{
   
   // Defines the strings to compare.
   String^ myStr1 = "calle";
   String^ myStr2 = "calor";
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"es-ES" culture with international sort.
   CompareInfo^ myCompIntl = CompareInfo::GetCompareInfo( "es-ES" );
   
   // Uses GetCompareInfo to create the CompareInfo that 
   // uses the S"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
*/

// 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

*/

' 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.

Imports System.Globalization

Public Class SamplesCompareInfo

   Public Shared Sub Main()

      ' Defines the strings to compare.
      Dim myStr1 As [String] = "calle"
      Dim myStr2 As [String] = "calor"

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

      ' Uses GetCompareInfo to create the CompareInfo that uses the "es-ES" culture with traditional sort.
      Dim myCompTrad As CompareInfo = CompareInfo.GetCompareInfo(&H40A)

      ' Uses the CompareInfo property of the InvariantCulture.
      Dim myCompInva As CompareInfo = 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))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "calle" and "calor"
'   With myCompIntl.Compare: -1
'   With myCompTrad.Compare: 1
'   With myCompInva.Compare: -1

GetCompareInfo(Int32, Assembly)

Исходный код:

CompareInfo.cs

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

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

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

static member GetCompareInfo : int * System.Reflection.Assembly -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (culture As Integer, assembly As Assembly) As CompareInfo

Параметры

culture

Int32

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

assembly

Assembly

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

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

CompareInfo

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

Исключения

ArgumentNullException

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

ArgumentException

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

Комментарии

Примечание

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

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

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

• Assembly

GetCompareInfo(String, Assembly)

Исходный код:

CompareInfo.cs

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

public:
 static System::Globalization::CompareInfo ^ GetCompareInfo(System::String ^ name, System::Reflection::Assembly ^ assembly);

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

static member GetCompareInfo : string * System.Reflection.Assembly -> System.Globalization.CompareInfo

Public Shared Function GetCompareInfo (name As String, assembly As Assembly) As CompareInfo

Параметры

name

String

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

assembly

Assembly

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

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

CompareInfo

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

Исключения

ArgumentNullException

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

-или-

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

ArgumentException

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

-или-

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

Комментарии

Примечание

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

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

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

• Assembly