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

Definição

Namespace:: System

Assemblies:: mscorlib.dll, System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: System.Runtime.dll

Assembly:: netstandard.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Representa uma tupla de 6 ou sextupla.

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

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

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

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

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

type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
    interface ITuple

type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple

Public Class Tuple(Of T1, T2, T3, T4, T5, T6)
Implements IComparable, IStructuralComparable, IStructuralEquatable

Public Class Tuple(Of T1, T2, T3, T4, T5, T6)
Implements IComparable, IStructuralComparable, IStructuralEquatable, ITuple

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.

Herança: Object
Tuple<T1,T2,T3,T4,T5,T6>

Atributos: SerializableAttribute

Implementações: IStructuralComparable IStructuralEquatable IComparable ITuple

Comentários

Uma tupla é uma estrutura de dados que tem um número específico e uma sequência de valores. A Tuple<T1,T2,T3,T4,T5,T6> classe representa uma tupla de 6 ou sextupla, que é uma tupla que tem seis componentes.

Você pode criar uma instância de um Tuple<T1,T2,T3,T4,T5,T6> objeto chamando o Tuple<T1,T2,T3,T4,T5,T6> método estático ou o método estático Tuple.Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6) . Você pode recuperar o valor dos componentes da tupla usando as propriedades somente Item1leitura, Item2, Item3e Item4instânciaItem5 Item6.

As tuplas são comumente 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 e manipulação de um conjunto de dados. O exemplo a seguir define um Tuple<T1,T2,T3,T4,T5,T6> objeto que contém dados populacionais da cidade de Nova York para cada censo de 1960 a 2000. A sextupla é passada para o ComputePopulationChange método, que calcula a taxa anual de alteração entre censos, bem como a taxa anual de alteração durante todo o período de 50 anos.

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 %

open System

let computePopulationChange (data: Tuple<string, int, int, int, int, int>) =  
    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))

// Get population data for New York City, 1960-2000.
let population = 
      Tuple.Create("New York", 7781984, 7894862, 7071639, 7322564, 8008278)
let rate = computePopulationChange population
// Display results.
printfn $"Population Change, {population.Item1}, 1960-2000\n"
printfn $"""Year      {"Population",10} {"Annual Rate",9}"""
printfn $"""1960      {population.Item2,10:N0} {"NA",11}"""
printfn $"1970      {population.Item3,10:N0} {rate.Item2 / 10.,11:P2}"
printfn $"1980      {population.Item4,10:N0} {rate.Item3 / 10.,11:P2}"
printfn $"1990      {population.Item5,10:N0} {rate.Item4 / 10.,11:P2}"
printfn $"2000      {population.Item6,10:N0} {rate.Item5 / 10.,11:P2}"
printfn $"""1960-2000 {"",10:N0} {rate.Item6 / 50.,11:P2}"""

// 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 %

Module Example
   Public Sub Main()
      ' Get population data for New York City, 1960-2000.
      Dim population = Tuple.Create(
                     "New York", 7781984, 7894862, 7071639, 7322564, 8008278)
      Dim rate = ComputePopulationChange(population)      
      ' Display results.
      Console.WriteLine("Population Change, {0}, 1960-2000", population.Item1)
      Console.WriteLine()
      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)
   End Sub
   
      ' Compute rate of population change by decade and overall.
   Private Function ComputePopulationChange(data As Tuple(Of String, Integer, Integer, Integer, Integer, Integer)) _ 
           As Tuple(Of String, Double, Double, Double, Double, Double)
      Dim rate = Tuple.Create(data.Item1, 
                              (data.Item3 - data.Item2)/data.Item2, 
                              (data.Item4 - data.Item3)/data.Item3, 
                              (data.Item5 - data.Item4)/data.Item4, 
                              (data.Item6 - data.Item5)/data.Item5,
                              (data.Item6 - data.Item2)/data.Item2 )
      Return rate
   End Function           
End Module
' 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 %

Para retornar vários valores de um método sem o uso de out parâmetros (em C#) ou ByRef parâmetros (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> objeto.
Para passar vários valores para um método por meio de um único parâmetro. Por exemplo, o Thread.Start(Object) método tem um único parâmetro que permite fornecer um valor para o método que o thread executa na inicialização. Se você fornecer um Tuple<T1,T2,T3,T4,T5,T6> objeto como o argumento do método, poderá fornecer a rotina de inicialização do thread seis itens de dados.

Construtores

Nome	Description
Tuple<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)	Inicializa uma nova instância da classe Tuple<T1,T2,T3,T4,T5,T6>.

Propriedades

Nome	Description
Item1	Obtém o valor do primeiro componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
Item2	Obtém o valor do segundo componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
Item3	Obtém o valor do terceiro componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
Item4	Obtém o valor do quarto componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
Item5	Obtém o valor do quinto componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
Item6	Obtém o valor do sexto componente do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .

Métodos

Nome	Description
Equals(Object)	Retorna um valor que indica se o objeto atual Tuple<T1,T2,T3,T4,T5,T6> é igual a um objeto especificado.
GetHashCode()	Retorna o código hash do objeto atual Tuple<T1,T2,T3,T4,T5,T6> .
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o valor dessa Tuple<T1,T2,T3,T4,T5,T6> instância.

Implantações explícitas de interface

Nome	Description
IComparable.CompareTo(Object)	Compara o objeto atual Tuple<T1,T2,T3,T4,T5,T6> com um objeto especificado e retorna um inteiro que indica se o objeto atual está antes, depois ou na mesma posição que o objeto especificado na ordem de classificação.
IStructuralComparable.CompareTo(Object, IComparer)	Compara o objeto atual Tuple<T1,T2,T3,T4,T5,T6> com um objeto especificado usando um comparador especificado e retorna um inteiro que indica se o objeto atual está antes, depois ou na mesma posição que o objeto especificado na ordem de classificação.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Retorna um valor que indica se o objeto atual Tuple<T1,T2,T3,T4,T5,T6> é igual a um objeto especificado com base em um método de comparação especificado.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Calcula o código hash do objeto atual Tuple<T1,T2,T3,T4,T5,T6> usando um método de computação especificado.
ITuple.Item[Int32]	Obtém o valor do elemento especificado `Tuple` .
ITuple.Length	Obtém o número de elementos no `Tuple`.

Métodos de Extensão

Nome	Description
Deconstruct<T1,T2,T3,T4,T5,T6>(Tuple<T1,T2,T3,T4,T5,T6>, T1, T2, T3, T4, T5, T6)	Desconstrói uma tupla com 6 elementos em variáveis separadas.
ToValueTuple<T1,T2,T3,T4,T5,T6>(Tuple<T1,T2,T3,T4,T5,T6>)	Converte uma instância da `Tuple` classe em uma instância da `ValueTuple` estrutura.

Aplica-se a

Confira também

Comentários

Esta página foi útil?