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<T1, T2, T3, T4, T5, T6, T7>

.NET Framework (current version)
 

Publicado: agosto de 2016

Representa uma tupla de 7 ou sétupla.

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

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

[SerializableAttribute]
public class Tuple<T1, T2, T3, T4, T5, T6, T7> : IStructuralEquatable, 
	IStructuralComparable, IComparable

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 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.

NomeDescrição
System_CAPS_pubmethodTuple<T1, T2, T3, T4, T5, T6, T7>(T1, T2, T3, T4, T5, T6, T7)

Inicializa uma nova instância da classe Tuple<T1, T2, T3, T4, T5, T6, T7>.

NomeDescrição
System_CAPS_pubpropertyItem1

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> primeiro componente do objeto.

System_CAPS_pubpropertyItem2

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> segundo componente do objeto.

System_CAPS_pubpropertyItem3

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> terceiro componente do objeto.

System_CAPS_pubpropertyItem4

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> quarto componente do objeto.

System_CAPS_pubpropertyItem5

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> quinto componente do objeto.

System_CAPS_pubpropertyItem6

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> componente sexto do objeto.

System_CAPS_pubpropertyItem7

Obtém o valor do atual Tuple<T1, T2, T3, T4, T5, T6, T7> componente sétimo do objeto.

NomeDescrição
System_CAPS_pubmethodEquals(Object)

Retorna um valor que indica se o atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto é igual ao objeto especificado.(Substitui o Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes que ele seja recuperado pela coleta de lixo. (Herdado de Object.)

System_CAPS_pubmethodGetHashCode()

Retorna o código hash para a atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto.(Substitui o Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtém o Type da instância atual.(Herdado de Object.)

System_CAPS_protmethodMemberwiseClone()

Cria uma cópia superficial do Object atual.(Herdado de Object.)

System_CAPS_pubmethodToString()

Retorna uma cadeia de caracteres que representa o valor desse Tuple<T1, T2, T3, T4, T5, T6, T7> instância.(Substitui o Object.ToString().)

NomeDescrição
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralComparable.CompareTo(Object, IComparer)

Compara atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto para um objeto especificado usando um comparador especificado e retorna um inteiro que indica se o objeto atual é antes, depois ou na mesma posição do objeto especificado na ordem de classificação.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.Equals(Object, IEqualityComparer)

Retorna um valor que indica se o atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto é igual ao objeto especificado com base em um método de comparação especificado.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.GetHashCode(IEqualityComparer)

Calcula o código hash para a atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto usando um método de cálculo especificada.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIComparable.CompareTo(Object)

Compara atual Tuple<T1, T2, T3, T4, T5, T6, T7> objeto para um objeto especificado e retorna um inteiro que indica se o objeto atual é antes, depois ou na mesma posição do objeto especificado na ordem de classificação.

Tupla é uma estrutura de dados que possui um número específico e uma sequência de valores. O Tuple<T1, T2, T3, T4, T5, T6, T7> classe representa uma tupla de 7 ou sétupla, que é uma tupla que tem sete componentes.

Você pode instanciar uma Tuple<T1, T2, T3, T4, T5, T6, T7> objeto chamando o Tuple<T1, T2, T3, T4, T5, T6, T7> ou estático Tuple.Create<T1, T2, T3, T4, T5, T6, T7>(T1, T2, T3, T4, T5, T6, T7) método. Você pode recuperar o valor dos componentes da tupla usando somente leitura Item1, Item2, Item3, Item4, Item5, Item6, e Item7 propriedades da instância.

As tuplas costumam ser usadas de quatro maneiras diferentes:

  • 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. O exemplo a seguir define uma Tuple<T1, T2, T3, T4, T5, T6, T7> objeto que contém dados de população cidade de Nova York, para cada censo de 1950 até 2000. O sétupla é passada para o ComputePopulationChange método, que calcula a taxa de alteração entre censuses, bem como a taxa de alteração para o período do ano inteiro de 60 anual anual.

    using System;
    
    public class Example
    {
       public static void Main()
       {
          // Get population data for New York City, 1950-2000.
          var population = Tuple.Create("New York", 7891957, 7781984, 
                                        7894862, 7071639, 7322564, 8008278);
          var rate = ComputePopulationChange(population);
          // Display results.
          Console.WriteLine("Population Change, {0}, 1950-2000\n", population.Item1);
          Console.WriteLine("Year      {0,10} {1,9}", "Population", "Annual Rate");
          Console.WriteLine("1950      {0,10:N0} {1,11}", population.Item2, "NA");
          Console.WriteLine("1960      {0,10:N0} {1,11:P2}", population.Item3, rate.Item2/10);
          Console.WriteLine("1970      {0,10:N0} {1,11:P2}", population.Item4, rate.Item3/10);
          Console.WriteLine("1980      {0,10:N0} {1,11:P2}", population.Item5, rate.Item4/10);
          Console.WriteLine("1990      {0,10:N0} {1,11:P2}", population.Item6, rate.Item5/10);
          Console.WriteLine("2000      {0,10:N0} {1,11:P2}", population.Item7, rate.Item6/10);
          Console.WriteLine("1950-2000 {0,10:N0} {1,11:P2}", "", rate.Item7/50);
       }
    
       private static Tuple<string, double, double, double, double, double, double> 
            ComputePopulationChange(
               Tuple<string, int, 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.Item7 - data.Item6)/data.Item6,
                           (double)(data.Item7 - data.Item2)/data.Item2 );
          return rate;
       }           
    }
    // The example displays the following output:
    //       Population Change, New York, 1950-2000
    //       
    //       Year      Population Annual Rate
    //       1950       7,891,957          NA
    //       1960       7,781,984     -0.14 %
    //       1970       7,894,862      0.15 %
    //       1980       7,071,639     -1.04 %
    //       1990       7,322,564      0.35 %
    //       2000       8,008,278      0.94 %
    //       1950-2000                 0.03 %
    
  • Para retornar vários valores de um método sem o uso de parâmetros out (no C#) ou de parâmetros ByRef (no Visual Basic). Por exemplo, o exemplo anterior retorna suas estatísticas computadas, juntamente com o nome da cidade, em um Tuple<T1, T2, T3, T4, T5, T6, T7> objeto.

  • Para passar vários valores para um método por meio de um parâmetro único. Por exemplo, o método Thread.Start(Object) tem um único parâmetro que permite fornecer um valor ao método que o thread executa na inicialização. Se você fornecer uma Tuple<T1, T2, T3, T4, T5, T6, T7> objeto como o argumento de método, você pode fornecer a rotina de inicialização do thread com sete itens de dados.

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: