• Article

Tuple.Create<T1, T2, T3, T4, T5, T6, T7, T8> Method (T1, T2, T3, T4, T5, T6, T7, T8)

Microsoft Silverlight will reach end of support after October 2021. Learn more.

Creates a new 8-tuple, or octuple.

Namespace:  System
Assembly:  mscorlib (in mscorlib.dll)

Syntax

'Declaration
Public Shared Function Create(Of T1, T2, T3, T4, T5, T6, T7, T8) ( _
    item1 As T1, _
    item2 As T2, _
    item3 As T3, _
    item4 As T4, _
    item5 As T5, _
    item6 As T6, _
    item7 As T7, _
    item8 As T8 _
) As Tuple(Of T1, T2, T3, T4, T5, T6, T7, Tuple(Of T8))

public static Tuple<T1, T2, T3, T4, T5, T6, T7, Tuple<T8>> Create<T1, T2, T3, T4, T5, T6, T7, T8>(
    T1 item1,
    T2 item2,
    T3 item3,
    T4 item4,
    T5 item5,
    T6 item6,
    T7 item7,
    T8 item8
)

Type Parameters

  • T1
    The type of the first component of the tuple.
  • T2
    The type of the second component of the tuple.
  • T3
    The type of the third component of the tuple.
  • T4
    The type of the fourth component of the tuple.
  • T5
    The type of the fifth component of the tuple.
  • T6
    The type of the sixth component of the tuple.
  • T7
    The type of the seventh component of the tuple.
  • T8
    The type of the eighth component of the tuple.

Parameters

  • item1
    Type: T1
    The value of the first component of the tuple.
  • item2
    Type: T2
    The value of the second component of the tuple.
  • item3
    Type: T3
    The value of the third component of the tuple.
  • item4
    Type: T4
    The value of the fourth component of the tuple.
  • item5
    Type: T5
    The value of the fifth component of the tuple.
  • item6
    Type: T6
    The value of the sixth component of the tuple.
  • item7
    Type: T7
    The value of the seventh component of the tuple.
  • item8
    Type: T8
    The value of the eighth component of the tuple.

Return Value

Type: System.Tuple<T1, T2, T3, T4, T5, T6, T7, Tuple<T8>>
An 8-tuple (octuple) whose value is (item1, item2, item3, item4, item5, item6, item7, item8).

Remarks

Create is a helper method that you can call to instantiate an 8-tuple without having to explicitly specify the types of its components.

NoteNote:

You must call the Tuple.Create<T1, T2, T3, T4, T5, T6, T7, T8>(T1, T2, T3, T4, T5, T6, T7, T8) constructor to create a tuple with nine or more components unless your language provides a special syntax for this purpose. The static (Shared in Visual Basic) methods of the Tuple class cannot be used to create a tuple with nine or more components.

Examples

The following example creates an 8-tuple whose components are prime numbers that are less than 20.

Dim primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)

var primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19);

This is equivalent to the following example, which uses the Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> class constructor instead of the Create factory creation method. Note that instantiating a Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> object in this way involves considerably more code, because you must declare a nested Tuple<T1> object as the Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> object's eighth component to produce an octuple.

Dim primes As New Tuple(Of Integer, Integer, Integer, Integer, _ 
                           Integer, Integer, Integer, _
                           Tuple(Of Integer)) _
                       (2, 3, 5, 7, 11, 13, 17, _
                        New Tuple(Of Integer)(19))

var primes = new Tuple<int, int, int, int, int, int, int,
                 Tuple<int>>(2, 3, 5, 7, 11, 13, 17,
                 new Tuple<int>(19));

Version Information

Silverlight

Supported in: 5, 4

Platforms

For a list of the operating systems and browsers that are supported by Silverlight, see Supported Operating Systems and Browsers.