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

來源:: CompareInfo.cs

來源:: 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.cs

來源:: 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.cs

來源:: 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.cs

來源:: 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

適用於

共用方式為

CompareInfo.GetCompareInfo 方法

定義

多載

GetCompareInfo(Int32)

參數

傳回

範例

適用於

GetCompareInfo(String)

參數

傳回

例外狀況

範例

適用於

GetCompareInfo(Int32, Assembly)

參數

傳回

例外狀況

備註

另請參閱

適用於

GetCompareInfo(String, Assembly)

參數

傳回

例外狀況

備註

另請參閱

適用於

其他資源