Tuple<T1,T2,T3,T4>.IComparable.CompareTo(Object) メソッド

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

現在の Tuple<T1,T2,T3,T4> オブジェクトと指定したオブジェクトを比較して、現在のオブジェクトが、並べ替え順序において、指定したオブジェクトの前後または同じ位置のいずれにあるかを示す整数を返します。

C#

int IComparable.CompareTo (object obj);

パラメーター

obj

Object

現在のインスタンスと比較するオブジェクト。

戻り値

Int32

並べ替え順序における、このインスタンスと obj の相対位置を示す符号付き整数値 (次の表を参照)。

値	説明
負の整数	このインスタンスの位置が obj よりも前です。
ゼロ	このインスタンスと obj の位置は、並べ替え順序において同じです。
正の整数	このインスタンスの位置が obj よりも後ろです。

実装

CompareTo(Object)

例外

ArgumentException

obj は Tuple<T1,T2,T3,T4> オブジェクトではありません。

例

次の例では、野球投手の Tuple<T1,T2,T3,T4> 名前、投球したイニングの数、および与えられたヒット数と獲得したラン数で構成されるコンポーネントを持つオブジェクトの配列を作成します。 配列内の各タプルのコンポーネントが並べ替えられていない順序で表示され、配列が並べ替えられた後、各タプルを並べ替えられた順序で表示する呼び出しが行 ToString われます。 出力は、配列が名前で並べ替えられたことを示しています。これは最初のコンポーネントです。 この例では、メソッドが直接呼び出されないことに IComparable.CompareTo(Object) 注意してください。 このメソッドは、配列内の各要素の Sort(Array) メソッドによって暗黙的に呼び出されます。

C#

using System;
using System.Collections.Generic;

public class Example
{
   public static void Main()
   {
      Tuple<string, decimal, int, int>[] pitchers  =  
                      { Tuple.Create("McHale, Joe", 240.1m, 221, 96),
                        Tuple.Create("Paul, Dave", 233.1m, 231, 84), 
                        Tuple.Create("Williams, Mike", 193.2m, 183, 86),
                        Tuple.Create("Blair, Jack", 168.1m, 146, 65), 
                        Tuple.Create("Henry, Walt", 140.1m, 96, 30),
                        Tuple.Create("Lee, Adam", 137.2m, 109, 45),
                        Tuple.Create("Rohr, Don", 101.0m, 110, 42) };

      // Display the array in unsorted order.
      Console.WriteLine("The values in unsorted order:");
      foreach (var pitcher in pitchers)
         Console.WriteLine(pitcher.ToString());
      Console.WriteLine();
      
      // Sort the array
      Array.Sort(pitchers);
      
      // Display the array in sorted order.
      Console.WriteLine("The values in sorted order:");
      foreach (var pitcher in pitchers)
         Console.WriteLine(pitcher.ToString());
   }
}
// The example displays the following output;
//       The values in unsorted order:
//       (McHale, Joe, 240.1, 221, 96)
//       (Paul, Dave, 233.1, 231, 84)
//       (Williams, Mike, 193.2, 183, 86)
//       (Blair, Jack, 168.1, 146, 65)
//       (Henry, Walt, 140.1, 96, 30)
//       (Lee, Adam, 137.2, 109, 45)
//       (Rohr, Don, 101, 110, 42)
//       
//       The values in sorted order:
//       (Blair, Jack, 168.1, 146, 65)
//       (Henry, Walt, 140.1, 96, 30)
//       (Lee, Adam, 137.2, 109, 45)
//       (McHale, Joe, 240.1, 221, 96)
//       (Paul, Dave, 233.1, 231, 84)
//       (Rohr, Don, 101, 110, 42)
//       (Williams, Mike, 193.2, 183, 86)

注釈

このメンバーは、明示的なインターフェイス メンバーの実装です。 これは、Tuple<T1,T2,T3,T4> のインスタンスが IComparable インターフェイスにキャストされる場合のみ、使用できます。

このメソッドは、クラスの IComparable.CompareTo 実装を Tuple<T1,T2,T3,T4> 提供します。 メソッドは直接呼び出すことができますが、最も一般的には、コレクションのメンバーを並べ替えるなど、Array.Sort(Array)SortedList.Addコレクション並べ替えメソッドの既定のオーバーロードによって呼び出されます。

注意事項

このメソッドは IComparable.CompareTo 、並べ替え操作で使用することを目的としています。 比較の主な目的が 2 つのオブジェクトが等しいかどうかを判断する場合は使用しないでください。 2 つのオブジェクトが等しいかどうかを判断するには、メソッドを Equals 呼び出します。

このメソッドでは IComparable.CompareTo 、既定のオブジェクト比較子を使用して各コンポーネントを比較します。

適用対象

こちらもご覧ください

• Equals(Object)