CompareInfo クラス

定義

名前空間:

System.Globalization

アセンブリ:

System.Runtime.dll

カルチャごとに異なる文字列比較を行うための一連のメソッドを実装します。

public ref class CompareInfo sealed : System::Runtime::Serialization::IDeserializationCallback

public sealed class CompareInfo : System.Runtime.Serialization.IDeserializationCallback

type CompareInfo = class
    interface IDeserializationCallback

Public NotInheritable Class CompareInfo
Implements IDeserializationCallback

継承

Object

CompareInfo

実装

IDeserializationCallback

例

次の例は、オブジェクトに関連付けられているオブジェクトがCompareInfoCultureInfo文字列比較にどのように影響するかを示しています。

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 可能になります。

無視された検索値

文字セットには無視できる文字が含まれています。これらの文字は、言語またはカルチャに依存した比較を実行する際には考慮されません。 や などのIndexOfLastIndexOf比較メソッドでは、カルチャに依存する比較を実行する場合、このような文字は考慮されません。 無視できる文字は次のとおりです。

• String.Empty. カルチャに依存する比較メソッドでは、検索対象の文字列の先頭 (インデックス 0) に空の文字列が常に見つかります。

• 比較オプションのために操作で考慮されないコード ポイントを持つ文字で構成される文字または文字列。特に、 オプションと CompareOptions.IgnoreSymbols オプションでは、CompareOptions.IgnoreNonSpaceシンボルと非スペース結合文字が無視される検索が生成されます。

• 言語的な意味を持たないコード ポイントを含む文字列。 たとえば、カルチャに依存する文字列比較では、ソフト ハイフン (U+00AD) は常に無視されます。

セキュリティの考慮事項

セキュリティ上の決定が文字列比較または大文字と小文字の変更に依存する場合は、 プロパティを InvariantCulture 使用して、オペレーティング システムのカルチャ設定に関係なく、動作が一貫していることを確認する必要があります。

Note

可能であれば、型のパラメーター CompareOptions を持つ文字列比較メソッドを使用して、予想される比較の種類を指定する必要があります。 一般的なルールとして、ユーザー インターフェイスに表示される文字列を比較し、セキュリティ比較に または OrdinalIgnoreCase を指定Ordinalするには、言語オプション (現在のカルチャを使用) を使用します。

プロパティ

LCID	現在の CompareInfo に対して適切な形式のカルチャ識別子を取得します。
Name	この CompareInfo による並べ替え操作に使用されるカルチャの名前を取得します。
Version	文字列の比較および並べ替えに使用される Unicode のバージョンに関する情報を取得します。

メソッド

Compare(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	2 つの読み取り専用文字スパンを比較します。
Compare(String, Int32, Int32, String, Int32, Int32)	文字列のセクションと別の文字列のセクションとを比較します。
Compare(String, Int32, Int32, String, Int32, Int32, CompareOptions)	指定した CompareOptions 値を使用して、ある文字列のセクションと別の文字列のセクションとを比較します。
Compare(String, Int32, String, Int32)	文字列の末尾部分と別の文字列の末尾部分とを比較します。
Compare(String, Int32, String, Int32, CompareOptions)	指定した CompareOptions 値を使用して、文字列の末尾部分と別の文字列の末尾部分とを比較します。
Compare(String, String)	2 つの文字列を比較します。
Compare(String, String, CompareOptions)	指定した CompareOptions 値を使用して、2 つの文字列を比較します。
Equals(Object)	指定したオブジェクトが、現在の CompareInfo オブジェクトと等しいかどうかを判断します。
GetCompareInfo(Int32)	指定した識別子のカルチャに関連付けられている新しい CompareInfo オブジェクトを初期化します。
GetCompareInfo(Int32, Assembly)	指定したカルチャに関連付けられ、指定した CompareInfo 内の文字列比較メソッドを使用する新しい Assembly オブジェクトを初期化します。
GetCompareInfo(String)	指定した名前のカルチャに関連付けられている新しい CompareInfo オブジェクトを初期化します。
GetCompareInfo(String, Assembly)	指定したカルチャに関連付けられ、指定した CompareInfo 内の文字列比較メソッドを使用する新しい Assembly オブジェクトを初期化します。
GetHashCode()	現在の CompareInfo のハッシュ関数として機能し、ハッシュ アルゴリズムや、ハッシュ テーブルのようなデータ構造に使用されます。
GetHashCode(ReadOnlySpan<Char>, CompareOptions)	指定した比較オプションに基づいて文字スパンに対するハッシュ コードを取得します。
GetHashCode(String, CompareOptions)	指定した比較オプションに基づいて文字列のハッシュ コードを取得します。
GetSortKey(ReadOnlySpan<Char>, Span<Byte>, CompareOptions)	指定の入力の並べ替えキーを計算します。
GetSortKey(String)	指定した文字列の並べ替えキーを取得します。
GetSortKey(String, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字列の SortKey オブジェクトを取得します。
GetSortKeyLength(ReadOnlySpan<Char>, CompareOptions)	指定の入力から生成される並べ替えキーのバイト総数を取得します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	指定の読み取り専用文字スパン内で最初に現れる部分文字列を検索します。
IndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	ソース文字列内での部分文字列の最初の出現を検索します。
IndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	指定の読み取り専用文字スパン内で最初に現れる Rune を検索します。
IndexOf(String, Char)	指定した文字を検索し、検索対象文字列全体内で最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, Char, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象文字列全体内でその文字が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, Char, Int32)	指定した文字を検索し、検索対象文字列の指定したインデックスから文字列の末尾までの範囲内で、その文字が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, Char, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象文字列の指定したインデックスから文字列の末尾までのセクション内で、その文字が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, Char, Int32, Int32)	指定した文字を検索し、検索対象文字列の指定したインデックスから始まり、指定した数の要素を含んでいる範囲内で、その文字が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, Char, Int32, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象文字列の指定したインデックスから始まり、指定した数の要素を含んでいる範囲内で、その文字が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String)	指定した部分文字列を検索し、検索対象文字列全体内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象文字列全体内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String, Int32)	指定した部分文字列を検索し、検索対象文字列の指定したインデックスから文字列の末尾までの範囲内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象文字列の指定したインデックスから文字列の末尾までの範囲内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String, Int32, Int32)	指定した部分文字列を検索し、検索対象文字列の指定したインデックスから始まり、指定した数の要素を含んでいる範囲内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IndexOf(String, String, Int32, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象文字列の指定したインデックスから始まり、指定した数の要素を含んでいる範囲内で、その部分文字列が最初に出現する位置の 0 から始まるインデックス番号を返します。
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	読み取り専用文字スパンが特定のプレフィックスから始まるかどうかを決定します。
IsPrefix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	文字列が特定のプレフィックスで始まるかどうかを判断します。
IsPrefix(String, String)	指定した検索対象文字列が指定したプリフィックスで始まるかどうかを判断します。
IsPrefix(String, String, CompareOptions)	指定した CompareOptions 値を使用して、指定した検索対象文字列が指定したプレフィックスで始まるかどうかを判断します。
IsSortable(Char)	指定した Unicode 文字の並べ替えが可能かどうかを示します。
IsSortable(ReadOnlySpan<Char>)	指定した Unicode 読み取り専用文字スパンの並べ替えが可能かどうかを示します。
IsSortable(Rune)	指定した Rune が並べ替え可能かどうかを示します。
IsSortable(String)	指定した Unicode 文字列の並べ替えが可能かどうかを示します。
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	読み取り専用文字スパンが特定のサフィックスから終わるかどうかを決定します。
IsSuffix(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	文字列が特定のサフィックスで終わるかどうかを判断します。
IsSuffix(String, String)	指定した検索対象文字列が指定したサフィックスで終わるかどうかを判断します。
IsSuffix(String, String, CompareOptions)	指定した CompareOptions 値を使用して、指定した検索対象文字列が、指定したサフィックスで終わるかどうかを判断します。
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions)	指定の読み取り専用文字スパン内で最後に現れる部分文字列を検索します。
LastIndexOf(ReadOnlySpan<Char>, ReadOnlySpan<Char>, CompareOptions, Int32)	ソース文字列内での部分文字列の最後の出現を検索します。
LastIndexOf(ReadOnlySpan<Char>, Rune, CompareOptions)	指定の読み取り専用文字スパン内で最後に現れる Rune を検索します。
LastIndexOf(String, Char)	指定した文字を検索し、検索対象文字列全体内でその文字が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, Char, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象文字列全体内でその文字が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, Char, Int32)	指定した文字を検索し、検索対象文字列の先頭から指定したインデックスまでの範囲内で、その文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, Char, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象の文字列の先頭から指定したインデックスまでの範囲内で、その文字が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, Char, Int32, Int32)	指定した文字を検索し、検索対象文字列の指定したインデックスで終了し、指定した数の要素を含んでいる範囲内で、その文字が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, Char, Int32, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した文字を検索し、検索対象文字列の指定したインデックスで終了し、指定した数の要素を含んでいる範囲内で、その文字が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String)	指定した部分文字列を検索し、検索対象文字列全体内で、その部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象文字列全体内でその部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String, Int32)	指定した部分文字列を検索し、検索対象文字列の先頭から指定したインデックスまでの範囲内で、その部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象の文字列の先頭から指定したインデックスまでの範囲内で、その部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String, Int32, Int32)	指定した部分文字列を検索し、検索対象文字列の指定したインデックスで終了し、指定した数の要素を含んでいる範囲内で、その部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
LastIndexOf(String, String, Int32, Int32, CompareOptions)	指定した CompareOptions 値を使用して、指定した部分文字列を検索し、検索対象文字列の指定したインデックスで終了し、指定した数の要素を含んでいる範囲内で、その部分文字列が最後に出現する位置の 0 から始まるインデックス番号を返します。
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在の CompareInfo オブジェクトを表す文字列を返します。

明示的なインターフェイスの実装

IDeserializationCallback.OnDeserialization(Object)

オブジェクト グラフ全体が逆シリアル化された時点で実行します。

拡張メソッド

GetStringComparer(CompareInfo, CompareOptions)

指定した CompareInfo オブジェクトの、カルチャを区別する文字列比較ルールに基づいて、StringComparer オブジェクトを返します。

こちらもご覧ください

• Windows オペレーティング システムの重みテーブルの並べ替え
• Linux および macOS の既定の Unicode 照合順序要素テーブル