Comparer クラス

リファレンス

定義

名前空間:: System.Collections

アセンブリ:: mscorlib.dll, System.Collections.NonGeneric.dll

アセンブリ:: System.Runtime.dll

アセンブリ:: System.Collections.NonGeneric.dll

アセンブリ:: System.Runtime.Extensions.dll

アセンブリ:: mscorlib.dll

アセンブリ:: netstandard.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

2 つのオブジェクトが等しいかどうかを比較します。文字列の大文字と小文字は区別されます。

public ref class Comparer sealed : System::Collections::IComparer

public ref class Comparer sealed : System::Collections::IComparer, System::Runtime::Serialization::ISerializable

public sealed class Comparer : System.Collections.IComparer

public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

[System.Serializable]
public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Comparer : System.Collections.IComparer, System.Runtime.Serialization.ISerializable

type Comparer = class
    interface IComparer

type Comparer = class
    interface IComparer
    interface ISerializable

[<System.Serializable>]
type Comparer = class
    interface IComparer
    interface ISerializable

[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Comparer = class
    interface IComparer
    interface ISerializable

Public NotInheritable Class Comparer
Implements IComparer

Public NotInheritable Class Comparer
Implements IComparer, ISerializable

継承: Object
Comparer

属性: SerializableAttribute ComVisibleAttribute

実装: IComparer ISerializable

例

次のコード例は、に関連付けられているカルチャに応じて異なる値を返す方法 Compare を Comparer示しています。

using namespace System;
using namespace System::Collections;
using namespace System::Globalization;
int main()
{
   
   // Creates the strings to compare.
   String^ str1 = "llegar";
   String^ str2 = "lugar";
   Console::WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 );
   
   // Uses the DefaultInvariant Comparer.
   Console::WriteLine( "   Invariant Comparer: {0}", Comparer::DefaultInvariant->Compare( str1, str2 ) );
   
   // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
   Comparer^ myCompIntl = gcnew Comparer( gcnew CultureInfo(  "es-ES",false ) );
   Console::WriteLine( "   International Sort: {0}", myCompIntl->Compare( str1, str2 ) );
   
   // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
   Comparer^ myCompTrad = gcnew Comparer( gcnew CultureInfo( 0x040A,false ) );
   Console::WriteLine( "   Traditional Sort  : {0}", myCompTrad->Compare( str1, str2 ) );
}

/*
This code produces the following output.

Comparing "llegar" and "lugar" ...
   Invariant Comparer: -1
   International Sort: -1
   Traditional Sort  : 1

*/

using System;
using System.Collections;
using System.Globalization;

public class SamplesComparer  {

   public static void Main()  {

      // Creates the strings to compare.
      String str1 = "llegar";
      String str2 = "lugar";
      Console.WriteLine( "Comparing \"{0}\" and \"{1}\" ...", str1, str2 );

      // Uses the DefaultInvariant Comparer.
      Console.WriteLine( "   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Comparer myCompIntl = new Comparer( new CultureInfo( "es-ES", false ) );
      Console.WriteLine( "   International Sort: {0}", myCompIntl.Compare( str1, str2 ) );

      // Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Comparer myCompTrad = new Comparer( new CultureInfo( 0x040A, false ) );
      Console.WriteLine( "   Traditional Sort  : {0}", myCompTrad.Compare( str1, str2 ) );
   }
}

/*
This code produces the following output.

Comparing "llegar" and "lugar" ...
   Invariant Comparer: -1
   International Sort: -1
   Traditional Sort  : 1

*/

Imports System.Collections
Imports System.Globalization

Public Class SamplesComparer

   Public Shared Sub Main()

      ' Creates the strings to compare.
      Dim str1 As [String] = "llegar"
      Dim str2 As [String] = "lugar"
      Console.WriteLine("Comparing ""{0}"" and ""{1}"" ...", str1, str2)

      ' Uses the DefaultInvariant Comparer.
      Console.WriteLine("   Invariant Comparer: {0}", Comparer.DefaultInvariant.Compare(str1, str2))

      ' Uses the Comparer based on the culture "es-ES" (Spanish - Spain, international sort).
      Dim myCompIntl As New Comparer(New CultureInfo("es-ES", False))
      Console.WriteLine("   International Sort: {0}", myCompIntl.Compare(str1, str2))

      ' Uses the Comparer based on the culture identifier 0x040A (Spanish - Spain, traditional sort).
      Dim myCompTrad As New Comparer(New CultureInfo(&H40A, False))
      Console.WriteLine("   Traditional Sort  : {0}", myCompTrad.Compare(str1, str2))

   End Sub

End Class


'This code produces the following output.
'
'Comparing "llegar" and "lugar" ...
'   Invariant Comparer: -1
'   International Sort: -1
'   Traditional Sort  : 1

注釈

このクラスは、インターフェイスの既定の IComparer 実装です。クラスは CaseInsensitiveComparer 、大文字と小文字を IComparer 区別しない文字列比較を実行するインターフェイスの実装です。 System.Collections.Generic.Comparer<T> は、このクラスに相当するジェネリックです。

比較プロシージャでは、特に Thread.CurrentCulture 指定がない限り、現在のスレッドのが使用されます。文字列比較の結果は、カルチャによって異なる場合があります。カルチャ固有の比較の詳細については、名前空間とグローバリゼーションとローカライズにSystem.Globalization関するページを参照してください。

コンストラクター

Comparer(CultureInfo)

指定した CultureInfo を使用して Comparer クラスの新しいインスタンスを初期化します。

フィールド

Default	現在のスレッドの Comparer に関連付けられた CurrentCulture のインスタンスを表します。このフィールドは読み取り専用です。
DefaultInvariant	Comparer に関連付けられた InvariantCulture のインスタンスを表します。このフィールドは読み取り専用です。

メソッド

Compare(Object, Object)	同じ型の 2 つのオブジェクトに対して大文字と小文字を区別する比較を実行し、一方が他方よりも小さいか、等しいか、大きいかを示す値を返します。
Equals(Object)	指定されたオブジェクトが現在のオブジェクトと等しいかどうかを判断します。 (継承元 Object)
GetHashCode()	既定のハッシュ関数として機能します。 (継承元 Object)
GetObjectData(SerializationInfo, StreamingContext)	SerializationInfo オブジェクトに、シリアル化に必要なデータを設定します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	現在のオブジェクトを表す文字列を返します。 (継承元 Object)

適用対象

Comparer クラス

定義

例

注釈

コンストラクター

フィールド

メソッド

適用対象

こちらもご覧ください

フィードバック

フィードバック

その他のリソース