Tuple.Create Método

Definição

Cria um novo objeto de tupla.

Sobrecargas

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

Cria uma nova tupla de 8 ou octupla.

Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

Cria uma nova tupla de 7 ou um sétuplo.

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

Cria uma nova tupla de 6 ou sêxtupla.

Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

Cria uma nova tupla de 5 ou quíntuplo.

Create<T1,T2,T3,T4>(T1, T2, T3, T4)

Cria uma nova tupla de 4 ou quádrupla.

Create<T1,T2,T3>(T1, T2, T3)

Cria uma nova tupla de 3 ou um triplo.

Create<T1,T2>(T1, T2)

Cria uma nova tupla de 2 ou par.

Create<T1>(T1)

Cria uma nova tupla de 1 ou singleton.

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

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 8 ou octupla.

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);

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

T4

O tipo do quarto tipo componente da tupla.

T5

O tipo do quinto componente da tupla.

T6

O tipo do sexto componente da tupla.

T7

O tipo do sétimo componente da tupla.

T8

O tipo do oitavo componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

item4
T4

O valor do quarto componente da tupla.

item5
T5

O valor do quinto componente da tupla.

item6
T6

O valor do sexto componente da tupla.

item7
T7

O valor do sétimo componente da tupla.

item8
T8

O valor do oitavo componente da tupla.

Retornos

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

Uma tupla de 8 (octupla) cujo valor é (item1, item2, item3, item4, item5, item6, item7 e item8).

Exemplos

O exemplo a seguir cria uma tupla de 8 cujos componentes são números primos menores que 20.

var primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19);
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19

Isso é equivalente ao exemplo a seguir, que usa o Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> construtor de classe em vez do método de criação de Create fábrica. Observe que criar uma instância de um Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> objeto dessa maneira envolve consideravelmente mais código, pois você deve declarar um objeto aninhado Tuple<T1> como o Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> oitavo componente do objeto para produzir uma octupla.

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

Comentários

Create é um método auxiliar que você pode chamar para instanciar uma tupla de 8 sem precisar especificar explicitamente os tipos de seus componentes.

Nota

Você deve chamar o Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> construtor para criar uma tupla com nove ou mais componentes, a menos que sua linguagem forneça uma sintaxe especial para essa finalidade. Os métodos estáticos (Shared no Visual Basic) da Tuple classe não podem ser usados para criar uma tupla com nove ou mais componentes.

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 7 ou um sétuplo.

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

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

T4

O tipo do quarto tipo componente da tupla.

T5

O tipo do quinto componente da tupla.

T6

O tipo do sexto componente da tupla.

T7

O tipo do sétimo componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

item4
T4

O valor do quarto componente da tupla.

item5
T5

O valor do quinto componente da tupla.

item6
T6

O valor do sexto componente da tupla.

item7
T7

O valor do sétimo componente da tupla.

Retornos

Uma tupla de 7 cujo valor é (item1, item2, item3, item4, item5, item6 e item7).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 7 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 7.

var tuple7 = Tuple.Create("Jane", 90, 87, 93, 67, 100, 92);
Console.WriteLine("Test scores for {0}: {1}, {2}, {3}, {4}, {5}, {6}",
                  tuple7.Item1, tuple7.Item2, tuple7.Item3,
                  tuple7.Item4, tuple7.Item5, tuple7.Item6,
                  tuple7.Item7);
// Displays Test scores for Jane: 90, 87, 93, 67, 100, 92

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2,T3,T4,T5,T6,T7> classe.

var tuple7 = new Tuple<string, int, int, int, int, int, int>
                      ("Jane", 90, 87, 93, 67, 100, 92);
Console.WriteLine("Test scores for {0}: {1}, {2}, {3}, {4}, {5}, {6}",
                  tuple7.Item1, tuple7.Item2, tuple7.Item3,
                  tuple7.Item4, tuple7.Item5, tuple7.Item6,
                  tuple7.Item7);
// Displays Test scores for Jane: 90, 87, 93, 67, 100, 92

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

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

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 6 ou sêxtupla.

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

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

T4

O tipo do quarto tipo componente da tupla.

T5

O tipo do quinto componente da tupla.

T6

O tipo do sexto componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

item4
T4

O valor do quarto componente da tupla.

item5
T5

O valor do quinto componente da tupla.

item6
T6

O valor do sexto componente da tupla.

Retornos

Uma tupla de 6 cujo valor é (item1, item2, item3, item4, item5, item6).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 6 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 6.

var tuple6 = Tuple.Create("Jane", 90, 87, 93, 67, 100);
Console.WriteLine("Test scores for {0}: {1}, {2}, {3}, {4}, {5}",
                  tuple6.Item1, tuple6.Item2, tuple6.Item3,
                  tuple6.Item4, tuple6.Item5, tuple6.Item6);
// Displays Test scores for Jane: 90, 87, 93, 67, 100

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2,T3,T4,T5,T6> classe.

var tuple6 = new Tuple<string, int, int, int, int, int>
                      ("Jane", 90, 87, 93, 67, 100);
Console.WriteLine("Test scores for {0}: {1}, {2}, {3}, {4}, {5}",
                  tuple6.Item1, tuple6.Item2, tuple6.Item3,
                  tuple6.Item4, tuple6.Item5, tuple6.Item6);
// Displays Test scores for Jane: 90, 87, 93, 67, 100

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 5 ou quíntuplo.

public static Tuple<T1,T2,T3,T4,T5> Create<T1,T2,T3,T4,T5> (T1 item1, T2 item2, T3 item3, T4 item4, T5 item5);

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

T4

O tipo do quarto tipo componente da tupla.

T5

O tipo do quinto componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

item4
T4

O valor do quarto componente da tupla.

item5
T5

O valor do quinto componente da tupla.

Retornos

Uma tupla de 5 cujo valor é (item1, item2, item3, item4 e item5).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 5 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 5.

var tuple5 = Tuple.Create("New York", 1990, 7322564, 2000, 8008278);
Console.WriteLine("{0}: {1:N0} in {2}, {3:N0} in {4}",
                  tuple5.Item1, tuple5.Item3, tuple5.Item2,
                  tuple5.Item5, tuple5.Item4);
// Displays New York: 7,322,564 in 1990, 8,008,278 in 2000

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2,T3,T4,T5> classe.

var tuple5 = new Tuple<string, int, int, int, int>
                      ("New York", 1990, 7322564, 2000, 8008278);
Console.WriteLine("{0}: {1:N0} in {2}, {3:N0} in {4}",
                  tuple5.Item1, tuple5.Item3, tuple5.Item2,
                  tuple5.Item5, tuple5.Item4);
// Displays New York: 7,322,564 in 1990, 8,008,278 in 2000

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1,T2,T3,T4>(T1, T2, T3, T4)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 4 ou quádrupla.

public static Tuple<T1,T2,T3,T4> Create<T1,T2,T3,T4> (T1 item1, T2 item2, T3 item3, T4 item4);

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

T4

O tipo do quarto tipo componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

item4
T4

O valor do quarto componente da tupla.

Retornos

Uma tupla de 4 cujo valor é (item1, item2, item3, item4).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 4 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 4.

var tuple4 = Tuple.Create("New York", 32.68, 51.87, 76.3);
Console.WriteLine("{0}: Hi {1}, Lo {2}, Ave {3}",
                  tuple4.Item1, tuple4.Item4, tuple4.Item2,
                  tuple4.Item3);
// Displays New York: Hi 76.3, Lo 32.68, Ave 51.87

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2,T3,T4>.Tuple<T1,T2,T3,T4> classe.

var tuple4 = new Tuple<string, double, double, double>
                      ("New York", 32.68, 51.87, 76.3);
Console.WriteLine("{0}: Hi {1}, Lo {2}, Ave {3}",
                  tuple4.Item1, tuple4.Item4, tuple4.Item2,
                  tuple4.Item3);
// Displays New York: Hi 76.3, Lo 32.68, Ave 51.87

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1,T2,T3>(T1, T2, T3)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 3 ou um triplo.

public static Tuple<T1,T2,T3> Create<T1,T2,T3> (T1 item1, T2 item2, T3 item3);

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

T3

O tipo do terceiro componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

item3
T3

O valor do terceiro componente da tupla.

Retornos

Uma tupla de 3 cujo valor é (item1, item2 e item3).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 3 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 3.

var tuple3 = Tuple.Create("New York", 32.68, 51.87);
Console.WriteLine("{0}: lo {1}, hi {2}", 
                  tuple3.Item1, tuple3.Item2, tuple3.Item3);
// Displays New York: lo 32.68, hi 51.87

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2,T3>.Tuple<T1,T2,T3> classe.

var tuple3 = new Tuple<string, double, double>
                      ("New York", 32.68, 51.87);
Console.WriteLine("{0}: lo {1}, hi {2}", 
                  tuple3.Item1, tuple3.Item2, tuple3.Item3);
// Displays New York: lo 32.68, hi 51.87

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1,T2>(T1, T2)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 2 ou par.

public static Tuple<T1,T2> Create<T1,T2> (T1 item1, T2 item2);

Parâmetros de tipo

T1

O tipo do primeiro componente da tupla.

T2

O tipo do segundo componente da tupla.

Parâmetros

item1
T1

O valor do primeiro componente da tupla.

item2
T2

O valor do segundo componente da tupla.

Retornos

Uma tupla de 2 cujo valor é (item1, item2).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 2 tuplas sem precisar especificar explicitamente os tipos de seus componentes. O exemplo a seguir usa o Create método para instanciar uma tupla de 2.

var tuple2 = Tuple.Create("New York", 32.68);
Console.WriteLine("{0}: {1}", tuple2.Item1, tuple2.Item2);
// Displays New York: 32.68

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1,T2> classe.

var tuple2 = new Tuple<string, double>("New York", 32.68);
Console.WriteLine("{0}: {1}", tuple2.Item1, tuple2.Item2);
// Displays New York: 32.68

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

Create<T1>(T1)

Origem:
Tuple.cs
Origem:
Tuple.cs
Origem:
Tuple.cs

Cria uma nova tupla de 1 ou singleton.

public static Tuple<T1> Create<T1> (T1 item1);

Parâmetros de tipo

T1

O tipo do único componente da tupla.

Parâmetros

item1
T1

O valor do único componente da tupla.

Retornos

Uma tupla cujo valor é (item1).

Comentários

Create é um método auxiliar que você pode chamar para instanciar um objeto de 1 tupla sem precisar especificar explicitamente o tipo de seu componente. O exemplo a seguir usa o Create método para instanciar uma tupla de 1 cujo componente é do tipo Int32.

var tuple1 = Tuple.Create(12);
Console.WriteLine(tuple1.Item1);     // Displays 12

Esse código é equivalente à chamada a seguir para o construtor de Tuple<T1> classe.

var tuple1 = new Tuple<int>(12);
Console.WriteLine(tuple1.Item1);     // Displays 12

Confira também

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0