CompareInfo.GetCompareInfo 方法

参考

定义

命名空间:: System.Globalization

程序集:: System.Runtime.dll

程序集:: mscorlib.dll

程序集:: netstandard.dll

程序集:: System.Globalization.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

初始化新的 CompareInfo 对象。

重载

GetCompareInfo(Int32)	初始化与具有指定标识符的区域性关联的新 CompareInfo 对象。
GetCompareInfo(String)	初始化与具有指定名称的区域性关联的新 CompareInfo 对象。
GetCompareInfo(Int32, Assembly)	初始化一个新的 CompareInfo 对象，该对象与指定区域性关联，并使用指定 Assembly 中的字符串比较方法。
GetCompareInfo(String, Assembly)	初始化一个新的 CompareInfo 对象，该对象与指定区域性关联，并使用指定 Assembly 中的字符串比较方法。

GetCompareInfo(Int32)

初始化与具有指定标识符的区域性关联的新 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 object associated with the 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 对象。

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 object associated with the 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 对象，该对象与指定区域性关联，并使用指定 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 对象，该对象与指定区域性关联，并使用指定 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

适用于

CompareInfo.GetCompareInfo 方法

定义

重载

GetCompareInfo(Int32)

参数

返回

示例

适用于

GetCompareInfo(String)

参数

返回

例外

示例

适用于

GetCompareInfo(Int32, Assembly)

参数

返回

例外

注解

另请参阅

适用于

GetCompareInfo(String, Assembly)

参数

返回

例外

注解

另请参阅

适用于

其他资源