Este artigo foi traduzido por máquina. Para visualizar o arquivo em inglês, marque a caixa de seleção Inglês. Você também pode exibir o texto Em inglês em uma janela pop-up, movendo o ponteiro do mouse sobre o texto.
Tradução
Inglês

Classe Tuple

.NET Framework (current version)
 

Publicado: agosto de 2016

Fornece métodos estáticos para criar objetos de tupla.

Para procurar o código-fonte do .NET Framework para este tipo, consulte o Reference Source.

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


public static class Tuple

NomeDescrição
System_CAPS_pubmethodSystem_CAPS_staticCreate<T1>(T1)

Cria uma nova tupla de 1 ou singleton.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2>(T1, T2)

Cria uma nova tupla de 2 ou par.

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

Cria uma nova tupla de 3 ou um triplo.

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

Cria uma nova tupla de 4 ou quádrupla.

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

Cria uma nova tupla de 5 ou quíntuplo.

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

Cria uma nova tupla de 6 ou sêxtupla.

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

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

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

Cria uma nova tupla de 8 ou octupla.

System_CAPS_noteObservação

Para exibir o código-fonte do .NET Framework para este tipo, consulte o Reference Source. Percorra o código-fonte online, baixe a referência para exibição offline e percorrer as fontes (incluindo atualizações e patches) durante a depuração; see instructions.

Uma tupla é uma estrutura de dados que tem um número específico e a sequência de elementos. Um exemplo de uma tupla é uma estrutura de dados com três elementos (conhecido como uma tupla de 3 ou tripla) que é usada para armazenar um identificador, como o nome de uma pessoa em um ano no segundo elemento e renda da pessoa para esse ano no terceiro elemento, o primeiro elemento. O .NET Framework oferece suporte diretamente a tuplas com os elementos de um a sete. Além disso, você pode criar tuplas de oito ou mais elementos de aninhamento de objetos de tupla no Rest propriedade de um Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> objeto.

Tuplas são comumente usadas em quatro maneiras:

  • Para representar um único conjunto de dados. Por exemplo, uma tupla pode representar um registro de banco de dados, e seus componentes podem representar campos individuais do registro.

  • Para fornecer acesso fácil a, e a manipulação de um conjunto de dados.

  • Para retornar vários valores de um método sem usar out parâmetros (c#) ou ByRef parâmetros (Visual Basic).

  • Para passar vários valores para um método por meio de um parâmetro único. Por exemplo, o Thread.Start(Object) método tem um único parâmetro que permite que você forneça um valor para o método que o thread é executado no momento da inicialização. Se você fornecer uma Tuple<T1, T2, T3> objeto como o argumento de método, você pode fornecer a rotina de inicialização do thread com três itens de dados.

O Tuple classe não se representa uma tupla. Em vez disso, é uma classe que fornece métodos estáticos para criar instâncias dos tipos de coleção de itens que são suportados pelo .NET Framework. Fornece métodos auxiliares que você pode chamar para instanciar objetos de tupla sem a necessidade de especificar explicitamente o tipo de cada componente de tupla.

Embora você possa criar uma instância de uma classe de tupla chamando o construtor de classe, o código para fazer isso pode ser trabalhoso. O exemplo a seguir usa um construtor de classe para criar uma tupla de 7 ou sétupla que contém dados de população cidade de Nova York, para cada censo de 1950 até 2000.

// Create a 7-tuple.
var population = new Tuple<string, int, int, int, int, int, int>(
                           "New York", 7891957, 7781984, 
                           7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278

Criando o mesmo objeto de tupla usando um método auxiliar é mais simples, como mostra o exemplo a seguir.

// Create a 7-tuple.
var population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278

O Create métodos auxiliares diretamente suportam à criação de objetos de tupla ter de uma a oito componentes (ou seja, singletons por meio de octuples). Embora não haja nenhum limite prático para o número de componentes pode ter uma tupla, métodos auxiliares não estão disponíveis para criar uma tupla com nove ou mais componentes. Para criar uma coleção de itens, você deve chamar o Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> construtor.

System_CAPS_noteObservação

Para obter informações adicionais e exemplos que usam tuplas, consulte a documentação para os tipos de coleção de itens individuais no .NET Framework. Eles estão listados na seção Consulte também no final deste tópico.

O exemplo a seguir cria uma 8 tuplas (octuple) que contém os números primos que são menos de 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

Plataforma Universal do Windows
Disponível desde 8
.NET Framework
Disponível desde 4.0
Biblioteca de Classes Portátil
Com suporte no: plataformas portáteis do .NET
Silverlight
Disponível desde 4.0
Windows Phone Silverlight
Disponível desde 8.0
Windows Phone
Disponível desde 8.1

Quaisquer membros estáticos públicos ( Compartilhado no Visual Basic) desse tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.

Retornar ao início
Mostrar: