Esporta (0) Stampa
Espandi tutto
Il presente articolo è stato tradotto automaticamente. Passare il puntatore sulle frasi nell'articolo per visualizzare il testo originale. Ulteriori informazioni.
Traduzione
Originale

Classe Tuple

Fornisce metodi statici per la creazione di oggetti tupla.

Spazio dei nomi:  System
Assembly:  mscorlib (in mscorlib.dll)

public static class Tuple

  NomeDescrizione
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1>(T1)Crea una nuova tupla con un solo elemento, ovvero un singleton.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2>(T1, T2)Crea una nuova tupla con due elementi, ovvero una coppia.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2, T3>(T1, T2, T3)Crea una nuova tupla con tre elementi, ovvero una terna.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2, T3, T4>(T1, T2, T3, T4)Crea una nuova tupla con quattro elementi, ovvero una quadrupla.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2, T3, T4, T5>(T1, T2, T3, T4, T5)Crea una nuova tupla con cinque elementi, ovvero una quintupla.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2, T3, T4, T5, T6>(T1, T2, T3, T4, T5, T6)Crea una nuova tupla con sei elementi, ovvero una sestupla.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<T1, T2, T3, T4, T5, T6, T7>(T1, T2, T3, T4, T5, T6, T7)Crea una nuova tupla con sette elementi, ovvero una settupla.
Metodo pubblicoMembro staticoSupportato da Libreria di classi portabileSupportato in .NET per applicazioni Windows StoreCreate<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.
In alto

Una tupla è una struttura dati caratterizzata da una quantità e un ordine specifico di elementi Un esempio di tupla è una struttura di dati con tre elementi (nota come 3-tupla o tripla) utilizzata per memorizzare un identificatore come il nome di una persona nel primo elemento, un anno nel secondo elemento e il reddito di quella persona per quell'anno nel terzo elemento. .NET Framework supporta direttamente le tuple che contengono da uno a sette elementi. 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>.

Le tuple sono comunemente utilizzate in quattro modalità:

  • Per rappresentare un solo set di dati. Ad esempio una tupla può rappresentare un record del database e i componenti possono rappresentare i singoli campi del record.

  • Per accedere e manipolare semplicemente un set di dati.

  • Per restituire più valori da un metodo senza l'utilizzo di parametri out (in C#) o di parametri ByRef (in Visual Basic).

  • Per passare più valori a un metodo tramite un solo parametro. Ad esempio, il metodo Thread.Start(Object) dispone di un solo parametro che consente di fornire un valore al metodo che il thread esegue nel momento dell'avvio. Se si fornisce un oggetto Tuple<T1, T2, T3> come argomento del metodo, è possibile fornire la routine di avvio del thread con tre elementi di dati.

La classe Tuple non rappresenta una tupla. Invece è una classe che fornisce metodi statici per la creazione di istanze dei tipi di tupla supportati da .NET Framework. Fornisce metodi di supporto che è possibile chiamare per istanziare oggetti tupla senza dover specificare in modo esplicito il tipo di ogni componente.

Sebbene sia possibile creare un'istanza di una classe tupla chiamando il costruttore della classe, il codice che esegue tale operazione può essere complesso. Nell'esempio seguente viene utilizzato il costruttore della classe per la creazione di una 7-tupla o settupla contenente i dati della popolazione di New York City per ogni censimento dal 1950 al 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
//       Population of New York in 2000: 8,008,278


Creare lo stesso oggetto tupla tramite un metodo di supporto è più semplice, come illustrato di seguito.


// 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
//       Population of New York in 2000: 8,008,278


I metodi di supporto Create sono utili per la creazione di oggetti tupla formati da uno fino a otto componenti (ovvero da singleton a ottuple). Anche se non esiste alcun limite pratico al numero di componenti che possono comporre una tupla, non sono disponibili metodi di supporto per creare una tupla con più di nove componenti. 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>.

NotaNota

Per ulteriori informazioni ed esempi che utilizzano le tuple, vedere la documentazione relativa ai tipi di tupla individuali in .NET Framework. Questi sono elencati nella sezione Ulteriori Informazioni alla fine di questo argomento.

Nell'esempio seguente viene creata una tupla con 8 componenti (ottupla) che contiene i numeri primi minori di 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.Item5, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 11, 11, 13, 17, and 19


.NET Framework

Supportato in: 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Supportato in: 4

Libreria di classi portabile

Supportato in: Libreria di classi portabile

.NET per applicazioni Windows Store

Supportato in: Windows 8

.NET per applicazioni Windows Phone

Supportato in: Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (ruoli di base del server non supportati), Windows Server 2008 R2 (ruoli di base del server supportati con SP1 o versione successiva, Itanium non supportato)

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema di .NET Framework.

Qualsiasi membro static (Shared in Visual Basic) pubblico di questo tipo è thread-safe. I membri di istanza non sono garantiti come thread-safe.

Aggiunte alla community

AGGIUNGI
Microsoft sta conducendo un sondaggio in linea per comprendere l'opinione degli utenti in merito al sito Web di MSDN. Se si sceglie di partecipare, quando si lascia il sito Web di MSDN verrà visualizzato il sondaggio in linea.

Si desidera partecipare?
Mostra:
© 2014 Microsoft