Tuple Tuple Tuple Tuple Class

Definizione

Fornisce metodi statici per la creazione di oggetti tupla.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Ereditarietà
TupleTupleTupleTuple

Esempi

L'esempio seguente crea una tupla con 8 componenti (ottupla) che contiene i numeri primi che sono meno di 20.The following example creates an 8-tuple (octuple) that contains prime numbers that are less than 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
Dim 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

Commenti

Una tupla è una struttura dati con un numero e una sequenza specificati di elementiA tuple is a data structure that has a specific number and sequence of elements. Un esempio di tupla è una struttura di dati costituita da tre elementi, nota come tupla con 3 elementi o terna, utilizzata per archiviare un identificatore come il nome di una persona nel primo elemento, un anno nel secondo elemento e il reddito della persona relativo a tale anno nel terzo elemento.An example of a tuple is a data structure with three elements (known as a 3-tuple or triple) that is used to store an identifier such as a person's name in the first element, a year in the second element, and the person's income for that year in the third element. .NET Framework supporta direttamente le tuple contenenti da uno a sette elementi.The .NET Framework directly supports tuples with one to seven elements. È inoltre possibile creare tuple di otto o più elementi annidando gli oggetti tupla nella proprietà Rest di un oggetto Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.In addition, you can create tuples of eight or more elements by nesting tuple objects in the Rest property of a Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> object.

Le tuple sono comunemente utilizzate in quattro modi:Tuples are commonly used in four ways:

  • Per rappresentare un singolo set di dati.To represent a single set of data. Ad esempio, una tupla può rappresentare un record di database e i relativi componenti possono rappresentare i singoli campi del record.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • Per fornire accesso semplificato alle e la manipolazione di, un set di dati.To provide easy access to, and manipulation of, a data set.

  • Per restituire più valori da un metodo senza utilizzare i parametri out in C# o i parametri ByRef in Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Per passare più valori a un metodo tramite un singolo parametro.To pass multiple values to a method through a single parameter. Ad esempio, il metodo Thread.Start(Object) dispone di un solo parametro che consente di fornire un unico valore al metodo eseguito dal thread al momento dell'avvio.For example, the Thread.Start(Object) method has a single parameter that lets you supply one value to the method that the thread executes at startup time. Se si fornisce un Tuple<T1,T2,T3> dell'oggetto come argomento del metodo, è possibile fornire routine di avvio del thread con tre elementi di dati.If you supply a Tuple<T1,T2,T3> object as the method argument, you can supply the thread's startup routine with three items of data.

La classe Tuple non rappresenta una tupla.The Tuple class does not itself represent a tuple. Si tratta invece di una classe che fornisce metodi statici per la creazione di istanze dei tipi di tupla supportati da .NET Framework.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. Tale classe fornisce i metodi di supporto che è possibile chiamare per creare istanze di oggetti tupla senza dover specificare in modo esplicito il tipo di ogni componente della tupla.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

Sebbene sia possibile creare un'istanza di una classe tupla chiamando il relativo costruttore, il codice che esegue tale operazione può essere complesso.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. Nell'esempio seguente viene utilizzato il costruttore della classe per la creazione di una tupla con sette elementi o settupla contenente i dati della popolazione di New York per ogni censimento dal 1950 al 2000.The following example uses a class constructor to create a 7-tuple or septuple that contains population data for New York City for each census from 1950 through 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
' Create a 7-tuple.
Dim population As New Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer) _
                           ("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

La creazione dello stesso oggetto tupla utilizzando un metodo di supporto è più semplice, come illustrato nell'esempio seguente.Creating the same tuple object by using a helper method is more straightforward, as the following example shows.

// 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
' Create a 7-tuple.
Dim 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

I metodi di supporto Create supportano direttamente la creazione di oggetti tupla che includono da uno a otto componenti i (da singleton a ottuple).The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). Anche se non esiste alcun limite concreto al numero di componenti può avere una tupla, metodi di supporto non sono disponibili per creare una tupla con nove o più componenti.Although there is no practical limit to the number of components a tuple may have, helper methods are not available to create a tuple with nine or more components. Per creare tale tupla, è necessario chiamare il costruttore Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.To create such a tuple, you must call the Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> constructor.

Nota

Per ulteriori informazioni ed esempi che utilizzano le tuple, vedere la documentazione relativa ai tipi di tupla individuali in .NET Framework.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Tali tipi di tupla sono elencati nella sezione Vedere anche alla fine di questo argomento.These are listed in the See Also section at the end of this topic.

Metodi

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

Crea una nuova tupla con 8 elementi, ovvero un'ottupla.Creates a new 8-tuple, or octuple.

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

Crea una nuova tupla con sette elementi, ovvero una settupla.Creates a new 7-tuple, or septuple.

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

Crea una nuova tupla con sei elementi, ovvero una sestupla.Creates a new 6-tuple, or sextuple.

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

Crea una nuova tupla con cinque elementi, ovvero una quintupla.Creates a new 5-tuple, or quintuple.

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

Crea una nuova tupla con quattro elementi, ovvero una quadrupla.Creates a new 4-tuple, or quadruple.

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

Crea una nuova tupla con tre elementi, ovvero una terna.Creates a new 3-tuple, or triple.

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

Crea una nuova tupla con due elementi, ovvero una coppia.Creates a new 2-tuple, or pair.

Create<T1>(T1) Create<T1>(T1) Create<T1>(T1) Create<T1>(T1)

Crea una nuova tupla con un solo elemento, ovvero un singleton.Creates a new 1-tuple, or singleton.

Si applica a

Vedi anche