CompareInfo 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
實作區分文化特性 (Culture) 的字串比較的一組方法。
public ref class CompareInfopublic ref class CompareInfo sealed : System::Runtime::Serialization::IDeserializationCallbackpublic ref class CompareInfo : System::Runtime::Serialization::IDeserializationCallbackpublic class CompareInfopublic sealed class CompareInfo : System.Runtime.Serialization.IDeserializationCallbackpublic class CompareInfo : System.Runtime.Serialization.IDeserializationCallback[System.Serializable]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallback[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public class CompareInfo : System.Runtime.Serialization.IDeserializationCallbacktype CompareInfo = classtype CompareInfo = class
interface IDeserializationCallback[<System.Serializable>]
type CompareInfo = class
interface IDeserializationCallback[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type CompareInfo = class
interface IDeserializationCallbackPublic Class CompareInfoPublic NotInheritable Class CompareInfo
Implements IDeserializationCallbackPublic Class CompareInfo
Implements IDeserializationCallback- 繼承
-
CompareInfo
- 屬性
- 實作
範例
下列範例顯示與 CultureInfo 物件相關聯的 物件如何影響 CompareInfo 字串比較。
using namespace System;
using namespace System::Text;
using namespace System::Globalization;
int main()
{
array<String^>^ sign = gcnew array<String^> { "<", "=", ">" };
// The code below demonstrates how strings compare
// differently for different cultures.
String^ s1 = "Coté";
String^ s2 = "coté";
String^ s3 = "côte";
// Set sort order of strings for French in France.
CompareInfo^ ci = (gcnew CultureInfo("fr-FR"))->CompareInfo;
Console::WriteLine(L"The LCID for {0} is {1}.", ci->Name, ci->LCID);
// Display the result using fr-FR Compare of Coté = coté.
Console::WriteLine(L"fr-FR Compare: {0} {2} {1}",
s1, s2, sign[ci->Compare(s1, s2, CompareOptions::IgnoreCase) + 1]);
// Display the result using fr-FR Compare of coté > côte.
Console::WriteLine(L"fr-FR Compare: {0} {2} {1}",
s2, s3, sign[ci->Compare(s2, s3, CompareOptions::None) + 1]);
// Set sort order of strings for Japanese as spoken in Japan.
ci = (gcnew CultureInfo("ja-JP"))->CompareInfo;
Console::WriteLine(L"The LCID for {0} is {1}.", ci->Name, ci->LCID);
// Display the result using ja-JP Compare of coté < côte.
Console::WriteLine("ja-JP Compare: {0} {2} {1}",
s2, s3, sign[ci->Compare(s2, s3) + 1]);
}
// This code produces the following output.
//
// The LCID for fr-FR is 1036.
// fr-FR Compare: Coté = coté
// fr-FR Compare: coté > côte
// The LCID for ja-JP is 1041.
// ja-JP Compare: coté < côte
using System;
using System.Text;
using System.Globalization;
public sealed class App
{
static void Main(string[] args)
{
String[] sign = new String[] { "<", "=", ">" };
// The code below demonstrates how strings compare
// differently for different cultures.
String s1 = "Coté", s2 = "coté", s3 = "côte";
// Set sort order of strings for French in France.
CompareInfo ci = new CultureInfo("fr-FR").CompareInfo;
Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);
// Display the result using fr-FR Compare of Coté = coté.
Console.WriteLine("fr-FR Compare: {0} {2} {1}",
s1, s2, sign[ci.Compare(s1, s2, CompareOptions.IgnoreCase) + 1]);
// Display the result using fr-FR Compare of coté > côte.
Console.WriteLine("fr-FR Compare: {0} {2} {1}",
s2, s3, sign[ci.Compare(s2, s3, CompareOptions.None) + 1]);
// Set sort order of strings for Japanese as spoken in Japan.
ci = new CultureInfo("ja-JP").CompareInfo;
Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID);
// Display the result using ja-JP Compare of coté < côte.
Console.WriteLine("ja-JP Compare: {0} {2} {1}",
s2, s3, sign[ci.Compare(s2, s3) + 1]);
}
}
// This code produces the following output.
//
// The LCID for fr-FR is 1036.
// fr-FR Compare: Coté = coté
// fr-FR Compare: coté > côte
// The LCID for ja-JP is 1041.
// ja-JP Compare: coté < côte
Imports System.Text
Imports System.Globalization
NotInheritable Public Class App
Shared Sub Main(ByVal args() As String)
Dim sign() As String = {"<", "=", ">"}
' The code below demonstrates how strings compare
' differently for different cultures.
Dim s1 As String = "Coté"
Dim s2 As String = "coté"
Dim s3 As String = "côte"
' Set sort order of strings for French in France.
Dim ci As CompareInfo = New CultureInfo("fr-FR").CompareInfo
Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID)
' Display the result using fr-FR Compare of Coté = coté.
Console.WriteLine("fr-FR Compare: {0} {2} {1}", _
s1, s2, sign((ci.Compare(s1, s2, CompareOptions.IgnoreCase) + 1)))
' Display the result using fr-FR Compare of coté > côte.
Console.WriteLine("fr-FR Compare: {0} {2} {1}", _
s2, s3, sign((ci.Compare(s2, s3, CompareOptions.None) + 1)))
' Set sort order of strings for Japanese as spoken in Japan.
ci = New CultureInfo("ja-JP").CompareInfo
Console.WriteLine("The LCID for {0} is {1}.", ci.Name, ci.LCID)
' Display the result using ja-JP Compare of coté < côte.
Console.WriteLine("ja-JP Compare: {0} {2} {1}", _
s2, s3, sign((ci.Compare(s2, s3) + 1)))
End Sub
End Class
' This code produces the following output.
'
' The LCID for fr-FR is 1036.
' fr-FR Compare: Coté = coté
' fr-FR Compare: coté > côte
' The LCID for ja-JP is 1041.
' ja-JP Compare: coté < côte
備註
比較和排序資料的慣例會因文化特性而異。 例如，排序次序可能以注音或字元的視覺表示為基礎。 在東亞語言中，字元會依筆劃和語意的根基排序。 排序也取決於字母順序所使用的順序語言和文化特性。 例如，丹麥文的 "Æ" 字元在字母順序中排列在 "Z" 之後。 此外，比較可能會區分大小寫或區分大小寫，而大小寫規則也可能因文化特性而異。 類別 CompareInfo 負責維護此區分文化特性的字串比較資料，以及執行區分文化特性的字串作業。
一般而言，您不需要直接具現化 CompareInfo 物件，因為所有非序數位符串比較作業都會隱含地使用物件，包括呼叫 String.Compare 方法。 不過，如果您想要擷取 CompareInfo 物件，您可以使用下列其中一種方式來執行此動作：
藉由擷取特定文化特性的 CultureInfo.CompareInfo 屬性值。
藉由呼叫具有文化特性名稱的靜態 GetCompareInfo 方法。 這允許晚期繫結存取 CompareInfo 物件。
忽略的搜尋值
字元集包含可忽略的字元，這些字元在執行語言或區分文化特性的比較時不列入考慮。 比較方法，例如 IndexOf 和 LastIndexOf 不會在執行區分文化特性的比較時考慮這類字元。 可忽略的字元包括：
String.Empty. 區分文化特性的比較方法一律會在搜尋字串的開頭 (索引零) 找到空字串。
字元或字串，其中包含因為比較選項而未在作業中考慮之字碼點的字元，特別是 CompareOptions.IgnoreNonSpace 和 CompareOptions.IgnoreSymbols 選項會產生搜尋，其中會忽略符號和非步調合併字元。
具有沒有語言重要性之字碼點的字串。 例如，在區分文化特性的字串比較中，一律會忽略虛連字號 (U+00AD) 。
安全性考量
如果安全性決策取決於字串比較或大小寫變更，您應該使用 InvariantCulture 屬性來確保行為一致，不論作業系統的文化特性設定為何。
注意
可能的話，您應該使用具有 型 CompareOptions 別參數的字串比較方法，以指定預期的比較類型。 一般規則是，使用語言選項 (使用目前的文化特性) 來比較使用者介面中顯示的字串，並指定 Ordinal 或 OrdinalIgnoreCase 進行安全性比較。
屬性
| LCID |
為目前的 CompareInfo 取得正確格式的文化特性識別項。 |
| Name |
取得由此 CompareInfo 物件進行排序作業所使用之文化特性的名稱。 |
| Version |
取得用於比較和排序字串的 Unicode 版本的相關資訊。 |
方法
明確介面實作
| IDeserializationCallback.OnDeserialization(Object) |
執行於整個物件 Graph 已經還原序列化時。 |
擴充方法
| GetStringComparer(CompareInfo, CompareOptions) |
根據所指定之 CompareInfo 物件的區分文化特性字串比較規則，傳回 StringComparer 物件。 |