StringComparer.Compare メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
2 つのオブジェクトまたは文字列を比較し、相対的な並べ替え順序を示す値を返します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Compare(Object, Object) |
派生クラスでオーバーライドされると、2 つのオブジェクトを比較し、それらの相対的な並べ替え順序を示す値を返します。 |
| Compare(String, String) |
派生クラスでオーバーライドされると、2 つの文字列を比較し、それらの相対並べ替え順序を示す値を返します。 |
Compare(Object, Object)
派生クラスでオーバーライドされると、2 つのオブジェクトを比較し、それらの相対的な並べ替え順序を示す値を返します。
public:
virtual int Compare(System::Object ^ x, System::Object ^ y);
public int Compare(object? x, object? y);
public int Compare(object x, object y);
abstract member Compare : obj * obj -> int
override this.Compare : obj * obj -> int
Public Function Compare (x As Object, y As Object) As Integer
パラメーター
- x
- Object
yと比較するオブジェクト。
- y
- Object
xと比較するオブジェクト。
返品
次の表に示すように、 x と yの相対値を示す符号付き整数。
| 価値 | 意味 |
|---|---|
| 0 未満 |
x が並べ替え順序で y 、または x が null され、 y が nullされていません。
|
| ゼロ |
x が yに等しいか、 x と y の両方が null。
|
| 0 より大きい |
x は並べ替え順序で y に従うか、 y が null され、 x が nullされていません。
|
実装
例外
xもyもStringオブジェクトでもなく、xもyもIComparableインターフェイスを実装しません。
注釈
StringComparer.Compare(String, String)メソッドは、比較を実行するためにStringComparer.Compare(Object, Object)引数とx引数の変換が必要ないため、yメソッドよりも若干効率的です。
適用対象
Compare(String, String)
派生クラスでオーバーライドされると、2 つの文字列を比較し、それらの相対並べ替え順序を示す値を返します。
public:
abstract int Compare(System::String ^ x, System::String ^ y);
public abstract int Compare(string x, string y);
public abstract int Compare(string? x, string? y);
abstract member Compare : string * string -> int
Public MustOverride Function Compare (x As String, y As String) As Integer
パラメーター
- x
- String
yと比較する文字列。
- y
- String
xと比較する文字列。
返品
次の表に示すように、 x と yの相対値を示す符号付き整数。
| 価値 | 意味 |
|---|---|
| 0 未満 |
x が並べ替え順序で y 、または x が null され、 y が nullされていません。
|
| ゼロ |
x が yに等しいか、 x と y の両方が null。
|
| 0 より大きい |
x は並べ替え順序で y に従うか、 y が null され、 x が nullされていません。
|
実装
注釈
StringComparer.Compare(String, String)メソッドは、比較を実行するためにStringComparer.Compare(Object, Object)引数とx引数の変換が必要ないため、yメソッドよりも若干効率的です。