Tuple<T1,T2,T3> Classe

Definição

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Representa uma tupla de 3 ou tripla.

C#

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

C#

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

C#

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

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.

Herança

Object

Tuple<T1,T2,T3>

Atributos

SerializableAttribute

Implementações

IStructuralComparable IStructuralEquatable IComparable ITuple

Comentários

Tupla é uma estrutura de dados que possui um número específico e uma sequência de valores. A Tuple<T1,T2,T3> classe representa uma tupla de 3 ou três, que é uma tupla que tem três componentes.

Você pode instanciar um Tuple<T1,T2,T3> objeto chamando o Tuple<T1,T2,T3> construtor ou o método estático Tuple.Create<T1,T2,T3>(T1, T2, T3) . Você pode recuperar os valores dos componentes da tupla usando as propriedades somente Item1Item2leitura e Item3 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 matriz de objetos Tuple<T1,T2,T3> que contêm os nomes de alunos, as pontuações de teste médias e o número de testes realizados. A matriz é passada para o ComputeStatistics método, que calcula a média e o desvio padrão das pontuações de teste.

  C#

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, double, int>[] scores = 
                      { Tuple.Create("Jack", 78.8, 8),
                        Tuple.Create("Abbey", 92.1, 9), 
                        Tuple.Create("Dave", 88.3, 9),
                        Tuple.Create("Sam", 91.7, 8), 
                        Tuple.Create("Ed", 71.2, 5),
                        Tuple.Create("Penelope", 82.9, 8),
                        Tuple.Create("Linda", 99.0, 9),
                        Tuple.Create("Judith", 84.3, 9) };
        var result = ComputeStatistics(scores);
        Console.WriteLine("Mean score: {0:N2} (SD={1:N2}) (n={2})", 
                          result.Item2, result.Item3, result.Item1);
     }
  
     private static Tuple<int, double, double> ComputeStatistics(Tuple<string, double, int>[] scores) 
     {
        int n = 0;
        double sum = 0;
  
        // Compute the mean.
        foreach (var score in scores)
        {
           n += score.Item3;
           sum += score.Item2 * score.Item3;
        }
        double mean = sum / n;
        
        // Compute the standard deviation.
        double ss = 0;
        foreach (var score in scores)
        {
           ss = Math.Pow(score.Item2 - mean, 2);
        }
        double sd = Math.Sqrt(ss/scores.Length);
        return Tuple.Create(scores.Length, mean, sd);
     }
  }
  // The example displays the following output:
  //       Mean score: 87.02 (SD=0.96) (n=8)
  

• 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 de pontuação de teste de resumo em um Tuple<T1,T2,T3> 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 um Tuple<T1,T2,T3> objeto como o argumento do método, poderá fornecer a rotina de inicialização do thread com três itens de dados.

Construtores

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

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

Propriedades

Item1	Obtém o valor do primeiro componente do objeto Tuple<T1,T2,T3> atual.
Item2	Obtém o valor do segundo componente do objeto Tuple<T1,T2,T3> atual.
Item3	Obtém o valor do terceiro componente do objeto Tuple<T1,T2,T3> atual.

Métodos

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

Implantações explícitas de interface

IComparable.CompareTo(Object)	Compara o objeto Tuple<T1,T2,T3> atual a 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 Tuple<T1,T2,T3> atual 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 do objeto especificado na ordem de classificação.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Retorna um valor que indica se o objeto Tuple<T1,T2,T3> atual é igual ao objeto especificado com base em um determinado método de comparação.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Calcula o código hash para o objeto Tuple<T1,T2,T3> atual usando um método de computação especificado.
ITuple.Item[Int32]	Obtém o valor do elemento Tuple especificado.
ITuple.Length	Obtém o número de elementos no Tuple.

Métodos de Extensão

Deconstruct<T1,T2,T3>(Tuple<T1,T2,T3>, T1, T2, T3)	Desconstrói uma tupla com três elementos em variáveis separadas.
ToValueTuple<T1,T2,T3>(Tuple<T1,T2,T3>)	Converte uma instância da classe Tuple em uma instância da estrutura ValueTuple.

Aplica-se a

Confira também

• Tuple
• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3,T4>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>