CaseInsensitiveComparer.Compare メソッド

.NET Framework クラス ライブラリ リファレンス

CaseInsensitiveComparer.Compare メソッド

同じ型の 2 つのオブジェクトに対して大文字小文字を区別しない比較を実行し、一方が他方よりも小さいか、等しいか、大きいかを示す値を返します。

名前空間: System.Collections
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Function Compare ( _
    a As Object, _
    b As Object _
) As Integer

Visual Basic (使用法)

Dim instance As CaseInsensitiveComparer
Dim a As Object
Dim b As Object
Dim returnValue As Integer

returnValue = instance.Compare(a, b)

C#

public int Compare (
    Object a,
    Object b
)

C++

public:
virtual int Compare (
    Object^ a, 
    Object^ b
) sealed

J#

public final int Compare (
    Object a, 
    Object b
)

JScript

public final function Compare (
    a : Object, 
    b : Object
) : int

パラメータ

a

比較対象の第 1 オブジェクト。

b

比較対象の第 2 オブジェクト。

戻り値

値	説明
0 より小さい値	a が b より小さい。大文字と小文字は区別されません。
0	a と b は等しい。大文字と小文字は区別されません。
0 より大きい値	a が b より大きい。大文字と小文字は区別されません。

例外

例外の種類	条件
ArgumentException	a と b が、いずれも IComparable インターフェイスを実装していません。 または a と b の型が異なります。

解説

a と b がどちらも文字列の場合、このメソッドは CompareInfo.Compare を使用して、大文字と小文字を無視して文字列の比較を行います。それ以外の場合は、いずれかのオブジェクトの IComparable 実装を使用します。つまり、a が IComparable を実装すると、このメソッドは a.CompareTo (b) という結果を返します。逆に、b が IComparable を実装する場合は、符号反転した b .CompareTo (a) が返されます。

null 参照 (Visual Basic では Nothing) を任意の型と比較できます。このような比較を行っても、IComparable を使用した場合に例外が生成されることはありません。並べ替え処理では、null 参照 (Visual Basic では Nothing) は、他のすべてのオブジェクトより小さいと見なされます。

文字列比較の結果は、カルチャに応じて異なる場合があります。カルチャ固有の比較の詳細については、System.Globalization 名前空間のトピックおよび「エンコーディングとローカリゼーション」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
CaseInsensitiveComparer クラス
CaseInsensitiveComparer メンバ
System.Collections 名前空間
IComparable インターフェイス
System.Globalization.CompareInfo
Thread.CurrentCulture
System.Globalization.CultureInfo
その他の技術情報
カルチャを認識しないコレクションの操作の実行