Questo articolo è stato tradotto automaticamente. Per visualizzare l'articolo in inglese, selezionare la casella di controllo Inglese. È possibile anche visualizzare il testo inglese in una finestra popup posizionando il puntatore del mouse sopra il testo.
Traduzione
Inglese

Classe Tuple

 

Data di pubblicazione: ottobre 2016

Fornisce metodi statici per la creazione di oggetti tupla.

Per esaminare il codice sorgente di .NET Framework per questo tipo, vedere il Reference Source.

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


public static class Tuple

NomeDescrizione
System_CAPS_pubmethodSystem_CAPS_staticCreate<T1>(T1)

Crea una nuova tupla con un solo elemento, ovvero un singleton.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2>(T1, T2)

Crea una nuova tupla con 2 elementi, ovvero una coppia.

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

Crea una nuova tupla con 3 elementi, ovvero una terna.

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

Crea una nuova tupla con 4 elementi, ovvero una quadrupla.

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

Crea una nuova tupla con 5 elementi, ovvero una quintupla.

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

Crea una nuova tupla con 6 elementi, ovvero una sestupla.

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

Crea una nuova tupla con 7 elementi, ovvero una settupla.

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

System_CAPS_noteNota

Per visualizzare il codice sorgente di .NET Framework per questo tipo, vedere il Reference Source. È possibile esplorare il codice sorgente online, scaricare i riferimenti per la visualizzazione offline e scorrere le origini (inclusi aggiornamenti e patch) durante l'esecuzione del debug. see instructions.

Una tupla è una struttura dati con un numero e una sequenza specificati di elementi 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. .NET Framework supporta direttamente le tuple contenenti 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 modi:

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

  • Per fornire facile accesso e la manipolazione di un set di dati.

  • Per restituire più valori da un metodo senza utilizzare i parametri out in C# o i parametri ByRef in Visual Basic).

  • Per passare più valori a un metodo tramite un singolo parametro. 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. Fornendo un oggetto Tuple<T1, T2, T3> come argomento del metodo, si specificano tre elementi di dati alla routine di avvio del thread.

La classe Tuple non rappresenta in sé una tupla. Si tratta invece di una classe che fornisce metodi statici per la creazione di istanze dei tipi di tupla supportati da .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.

Sebbene sia possibile creare un'istanza di una classe tupla chiamando il relativo costruttore, il codice che esegue tale operazione può essere complesso. L'esempio seguente utilizza il costruttore della classe per creare una tupla con sette elementi, o settupla, contenente i dati della popolazione di New York per ogni censimento tra gli anni 1950 e 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

La creazione dello stesso oggetto tupla utilizzando un metodo di supporto è più semplice, come illustrato nell'esempio seguente.

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

I metodi di supporto Create supportano direttamente la creazione di oggetti tupla che includono da uno a otto componenti (ovvero, da singleton a ottuple). Anche se non esiste alcun limite teorico al numero di componenti utilizzabili in una tupla, non sono disponibili metodi di supporto per creare una tupla con nove o più 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>.

System_CAPS_noteNota

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

Nell'esempio seguente si crea una tupla con 8 elementi (ottupla) che contiene numeri primi inferiori a 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

Universal Windows Platform
Disponibile da 8
.NET Framework
Disponibile da 4.0
Libreria di classi portabile
Supportato in: piattaforme .NET portabili
Silverlight
Disponibile da 4.0
Windows Phone Silverlight
Disponibile da 8.0
Windows Phone
Disponibile da 8.1

I membri statici pubblici ( Condiviso in Visual Basic) di questo tipo è thread safe. Non tutti i membri di istanza sono garantiti come thread safe.

Torna all'inizio
Mostra: