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

定義

名前空間:

System

アセンブリ:

System.Runtime.dll

アセンブリ:

mscorlib.dll

アセンブリ:

netstandard.dll

6 つ組、すなわちセクスチュープルを表します。

C#

public class Tuple<T1,T2,T3,T4,T5,T6> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

C#

public class Tuple<T1,T2,T3,T4,T5,T6> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple

C#

[System.Serializable]
public class Tuple<T1,T2,T3,T4,T5,T6> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

型パラメーター

T1

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

T2

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

T3

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

T4

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

T5

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

T6

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

継承

Object

Tuple<T1,T2,T3,T4,T5,T6>

属性

SerializableAttribute

実装

IStructuralComparable IStructuralEquatable IComparable ITuple

注釈

タプルは、特定の数値と値のシーケンスを持つデータ構造です。 クラスは Tuple<T1,T2,T3,T4,T5,T6> 、6 つのコンポーネントを持つタプルである 6 タプル (6 タプル) を表します。

または 静的Tuple.Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)メソッドをTuple<T1,T2,T3,T4,T5,T6>呼び出Tuple<T1,T2,T3,T4,T5,T6>すことで、オブジェクトをインスタンス化できます。 タプルのコンポーネントの値を取得するには、読み取り専用Item1Item4Item5Item2Item3、および Item6 インスタンス の各プロパティを使用します。

タプルは、一般的に次の 4 つの異なる方法で使用されます。

• 1 つのデータ セットを表す。 たとえば、タプルはデータベース レコードを表し、そのコンポーネントはレコードの個々のフィールドを表すことができます。

• データ セットへの簡単なアクセスと操作を提供します。 次の例では、 Tuple<T1,T2,T3,T4,T5,T6> 1960 年から 2000 年までの国勢調査ごとにニューヨーク市の人口データを含むオブジェクトを定義します。 6 分の 1 が メソッドに ComputePopulationChange 渡され、国勢調査間の年間変化率と、50 年間の年間変化率が計算されます。

  C#

  using System;
  
  public class Example
  {
     public static void Main()
     {
        // Get population data for New York City, 1960-2000.
        var population = 
             Tuple.Create("New York", 7781984, 7894862, 7071639, 7322564, 8008278);
        var rate = ComputePopulationChange(population);
        // Display results.
        Console.WriteLine("Population Change, {0}, 1960-2000\n", population.Item1);
        Console.WriteLine("Year      {0,10} {1,9}", "Population", "Annual Rate");
        Console.WriteLine("1960      {0,10:N0} {1,11}", population.Item2, "NA");
        Console.WriteLine("1970      {0,10:N0} {1,11:P2}", population.Item3, rate.Item2/10);
        Console.WriteLine("1980      {0,10:N0} {1,11:P2}", population.Item4, rate.Item3/10);
        Console.WriteLine("1990      {0,10:N0} {1,11:P2}", population.Item5, rate.Item4/10);
        Console.WriteLine("2000      {0,10:N0} {1,11:P2}", population.Item6, rate.Item5/10);
        Console.WriteLine("1960-2000 {0,10:N0} {1,11:P2}", "", rate.Item6/50);
     }
  
     private static Tuple<string, double, double, double, double, double> ComputePopulationChange(
             Tuple<string, int, int, int, int, int> data)  
     {           
        var rate = Tuple.Create(data.Item1, 
                                (double)(data.Item3 - data.Item2)/data.Item2, 
                                (double)(data.Item4 - data.Item3)/data.Item3, 
                                (double)(data.Item5 - data.Item4)/data.Item4, 
                                (double)(data.Item6 - data.Item5)/data.Item5,
                                (double)(data.Item6 - data.Item2)/data.Item2 );
        return rate;
     }           
  }
  // The example displays the following output:
  //       Population Change, New York, 1960-2000
  //       
  //       Year      Population Annual Rate
  //       1960       7,781,984          NA
  //       1970       7,894,862      0.15 %
  //       1980       7,071,639     -1.04 %
  //       1990       7,322,564      0.35 %
  //       2000       8,008,278      0.94 %
  //       1960-2000                 0.06 %
  

• パラメーター (C#では) またはByRefパラメーター (Visual Basic では) を使用outせずにメソッドから複数の値を返すには。 たとえば、前の例では、計算された統計情報と市区町村名を オブジェクトで Tuple<T1,T2,T3,T4,T5,T6> 返します。

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

コンストラクター

Tuple<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)

Tuple<T1,T2,T3,T4,T5,T6> クラスの新しいインスタンスを初期化します。

プロパティ

Item1	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 1 番目のコンポーネントの値を取得します。
Item2	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 2 番目のコンポーネントの値を取得します。
Item3	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 3 番目のコンポーネントの値を取得します。
Item4	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 4 番目のコンポーネントの値を取得します。
Item5	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 5 番目のコンポーネントの値を取得します。
Item6	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトの 6 番目のコンポーネントの値を取得します。

メソッド

Equals(Object)	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトが、指定されたオブジェクトと等しいかどうかを示す値を返します。
GetHashCode()	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトのハッシュ コードを返します。
GetType()	現在のインスタンスの Type を取得します。 (継承元 Object)
MemberwiseClone()	現在の Object の簡易コピーを作成します。 (継承元 Object)
ToString()	この Tuple<T1,T2,T3,T4,T5,T6> インスタンスの値を表す文字列を返します。

明示的なインターフェイスの実装

IComparable.CompareTo(Object)	現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトと指定したオブジェクトを比較して、現在のオブジェクトが、並べ替え順序において、指定したオブジェクトの前後または同じ位置のいずれにあるかを示す整数を返します。
IStructuralComparable.CompareTo(Object, IComparer)	指定された比較子を使用して現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトと指定されたオブジェクトを比較し、並べ替え順序において、現在のオブジェクトの位置が指定されたオブジェクトの前になるか、後ろになるか、同じになるかを示す整数を返します。
IStructuralEquatable.Equals(Object, IEqualityComparer)	指定された比較メソッドに基づいて、現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトが指定したオブジェクトと等しいかどうかを示す値を返します。
IStructuralEquatable.GetHashCode(IEqualityComparer)	指定した計算メソッドを使用して、現在の Tuple<T1,T2,T3,T4,T5,T6> オブジェクトのハッシュ コードを計算します。
ITuple.Item[Int32]	指定した Tuple 要素の値を取得します。
ITuple.Length	Tuple にある要素の数を取得します。

拡張メソッド

Deconstruct<T1,T2,T3,T4,T5,T6>(Tuple<T1,T2,T3,T4,T5,T6>, T1, T2, T3, T4, T5, T6)	6 要素を持つタプルを別個の変数に分解します。
ToValueTuple<T1,T2,T3,T4,T5,T6>(Tuple<T1,T2,T3,T4,T5,T6>)	クラスのインスタンスを Tuple 構造体のインスタンスに ValueTuple 変換します。

適用対象

こちらもご覧ください

• Tuple
• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• Tuple<T1,T2,T3,T4>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>