情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

Tuple<T1, T2, T3, T4, T5> クラス

2013/12/12

5 組 (5 つの要素で構成される組) を表します。

System.Object
  System.Tuple<T1, T2, T3, T4, T5>

Namespace:  System
アセンブリ:  mscorlib (mscorlib.dll 内)

public class Tuple<T1, T2, T3, T4, T5> : IStructuralComparable, 
	IStructuralEquatable, IComparable

型パラメーター

T1

組の 1 番目のコンポーネントの型。

T2

組の 2 番目のコンポーネントの型。

T3

組の 3 番目のコンポーネントの型。

T4

組の 4 番目のコンポーネントの型。

T5

組の 5 番目のコンポーネントの型。

Tuple<T1, T2, T3, T4, T5> 型で公開されるメンバーは以下のとおりです。

  名前説明
パブリック メソッドTuple<T1, T2, T3, T4, T5>Tuple<T1, T2, T3, T4, T5> クラスの新しいインスタンスを初期化します。
このページのトップへ

  名前説明
パブリック プロパティItem1現在の Tuple<T1, T2, T3, T4, T5> オブジェクトの 1 番目のコンポーネントの値を取得します。
パブリック プロパティItem2現在の Tuple<T1, T2, T3, T4, T5> オブジェクトの 2 番目のコンポーネントの値を取得します。
パブリック プロパティItem3現在の Tuple<T1, T2, T3, T4, T5> オブジェクトの 3 番目のコンポーネントの値を取得します。
パブリック プロパティItem4現在の Tuple<T1, T2, T3, T4, T5> オブジェクトの 4 番目のコンポーネントの値を取得します。
パブリック プロパティItem5現在の Tuple<T1, T2, T3, T4, T5> オブジェクトの 5 番目のコンポーネントの値を取得します。
このページのトップへ

  名前説明
パブリック メソッドEquals現在の Tuple<T1, T2, T3, T4, T5> オブジェクトが、指定されたオブジェクトと等しいかどうかを示す値を返します。 (Object.Equals(Object) をオーバーライドします。)
プロテクト メソッドFinalizeObject がガベージ コレクションで再利用される前に、Object がリソースを解放して他のクリーンアップ操作を実行できるようにします。 (Object から継承されます。)
パブリック メソッドGetHashCode現在の Tuple<T1, T2, T3, T4, T5> オブジェクトのハッシュ コードを返します。 (Object.GetHashCode() をオーバーライドします。)
パブリック メソッドGetType現在のインスタンスの Type を取得します。 (Object から継承されます。)
プロテクト メソッドMemberwiseClone現在の Object の簡易コピーを作成します。 (Object から継承されます。)
パブリック メソッドToStringこの Tuple<T1, T2, T3, T4, T5> インスタンスの値を表す文字列を返します。 (Object.ToString() をオーバーライドします。)
このページのトップへ

  名前説明
明示的なインターフェイスの実装プライベート メソッドIComparable.CompareTo現在の Tuple<T1, T2, T3, T4, T5> オブジェクトと指定されたオブジェクトを比較し、並べ替え順序において、現在のオブジェクトの位置が指定されたオブジェクトの前になるか、後ろになるか、同じになるかを示す整数を返します。
明示的なインターフェイスの実装プライベート メソッドIStructuralComparable.CompareTo指定された比較子を使用して現在の Tuple<T1, T2, T3, T4, T5> オブジェクトと指定されたオブジェクトを比較し、並べ替え順序において、現在のオブジェクトの位置が指定されたオブジェクトの前になるか、後ろになるか、同じになるかを示す整数を返します。
明示的なインターフェイスの実装プライベート メソッドIStructuralEquatable.Equals指定された比較メソッドに基づいて、現在の Tuple<T1, T2, T3, T4, T5> オブジェクトが指定したオブジェクトと等しいかどうかを示す値を返します。
明示的なインターフェイスの実装プライベート メソッドIStructuralEquatable.GetHashCode指定した計算メソッドを使用して、現在の Tuple<T1, T2, T3, T4, T5> オブジェクトのハッシュ コードを計算します。
このページのトップへ

組 (tuple) とは、特定の数およびシーケンスの値を持つデータ構造体です。Tuple<T1, T2, T3, T4, T5> クラスは、5 組 (5 つの要素で構成される組) を表します。

Tuple<T1, T2, T3, T4, T5> オブジェクトをインスタンス化するには、Tuple<T1, T2, T3, T4, T5> コンストラクターまたは静的 Tuple.Create<T1, T2, T3, T4, T5>(T1, T2, T3, T4, T5) メソッドを呼び出します。組の構成要素の値を取得するには、読み取り専用の Item1Item2Item3Item4、および Item5 の各インスタンス プロパティを使用します。

一般に、組には次の 4 種類の利用法があります。

  • 1 つのデータ セットを表現するため。たとえば、データベース レコードを組で表現し、レコードの個々のフィールドを組の構成要素で表現できます。

  • データ セットのアクセスと操作を容易にするため。次の例では、アメリカン フットボールのランニング バックの選手名、出場した試合数、試合中のキャリー数、総獲得ヤード数、タッチダウン数を含む Tuple<T1, T2, T3, T4, T5> オブジェクトの配列を定義します。配列を ComputeStatistics メソッドに渡すと、ゲームごとのキャリーのランニング バックの数、ゲームごとの平均ヤード、キャリーごとの平均ヤード、アテンプトごとの平均タッチダウン数が計算されます。

  • out パラメーター (C# の場合) または ByRef パラメーター (Visual Basic の場合) を使用せずに、メソッドから複数の値を返すため。たとえば、前の例では、計算した統計情報を選手の名前と共に Tuple<T1, T2, T3, T4, T5> オブジェクトの配列に格納して返します。

  • 1 つのパラメーターを使用してメソッドに複数の値を渡すため。たとえば、Thread.Start(Object) メソッドには、起動時にスレッドが実行するメソッドに 1 つの値を渡すために使用できる 1 つのパラメーターがあります。このメソッドの引数として Tuple<T1, T2, T3, T4, T5> オブジェクトを指定すると、スレッドの起動ルーチンに 5 つのデータ項目を渡すことができます。

Windows Phone OS

サポート: 8.0

この型のすべてのパブリック static (Visual Basic では Shared) メンバーは、スレッド セーフです。インスタンス メンバーの場合は、スレッド セーフであるとは限りません。

表示: