Tuple Třída

Definice

Obor názvů:

System

Sestavení:

netstandard.dll, System.Runtime.dll

Zdroj:

Tuple.cs

Poskytuje statické metody pro vytváření objektů řazené kolekce členů.

public ref class Tuple abstract sealed

public static class Tuple

type Tuple = class

Public Class Tuple

Dědičnost

Object

Tuple

Příklady

Následující příklad vytvoří 8-řazenou kolekci členů (octuple), která obsahuje prime čísla, která jsou menší než 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

open System

let primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)
printfn $"Prime numbers less than 20: {primes.Item1}, {primes.Item2}, {primes.Item3}, {primes.Item4}, {primes.Item5}, {primes.Item6}, {primes.Item7}, and {primes.Rest.Item1}"
//    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

Poznámky

Řazená kolekce členů je datová struktura, která má určitý počet a posloupnost prvků. Příkladem řazené kolekce členů je datová struktura se třemi prvky (označovanými jako třínásobná kolekce členů nebo trojitá kolekce členů), která slouží k uložení identifikátoru, jako je jméno osoby v prvním prvku, rok ve druhém prvku a příjem osoby za daný rok ve třetím prvku. Rozhraní .NET Framework přímo podporuje řazené kolekce členů s jedním až sedmi prvky. Kromě toho můžete vytvořit řazené kolekce členů osmi nebo více prvků vnořením objektů řazené kolekce členů ve Rest vlastnosti objektu Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> .

Řazené kolekce členů se běžně používají čtyřmi způsoby:

• Představuje jednu sadu dat. Například řazená kolekce členů může představovat záznam databáze a její komponenty mohou představovat jednotlivá pole záznamu.

• Pro zajištění snadného přístupu k datové sadě a manipulaci s nimi.

• Chcete-li vrátit více hodnot z metody bez použití out parametrů (v jazyce C#) nebo ByRef parametrů (v jazyce Visual Basic).

• Předání více hodnot metodě prostřednictvím jednoho parametru. Metoda má například Thread.Start(Object) jeden parametr, který umožňuje zadat jednu hodnotu metodě, kterou vlákno spouští při spuštění. Pokud jako argument metody zadáte Tuple<T1,T2,T3> objekt, můžete zadat spouštěcí rutinu vlákna se třemi položkami dat.

Třída Tuple sama o sobě nepředstavuje řazenou kolekci členů. Místo toho je to třída, která poskytuje statické metody pro vytváření instancí typů řazené kolekce členů, které jsou podporovány rozhraním .NET Framework. Poskytuje pomocné metody, které můžete volat k vytvoření instance objektů řazené kolekce členů, aniž byste museli explicitně určit typ každé součásti řazené kolekce členů.

Ačkoli můžete vytvořit instanci třídy řazené kolekce členů voláním jeho konstruktoru třídy, kód, který to provede, může být těžkopádný. Následující příklad používá konstruktor třídy k vytvoření 7-řazené kolekce členů nebo septuple, která obsahuje údaje o populaci pro New York City pro každý sčítání lidu z roku 1950 až 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.
let population = Tuple<string, int, int, int, int, int, int>(
                            "New York", 7891957, 7781984, 
                            7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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

Vytvoření stejného objektu řazené kolekce členů pomocí pomocné metody je jednodušší, jak ukazuje následující příklad.

// 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.
let population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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

Create Pomocné metody přímo podporují vytváření objektů řazené kolekce členů, které mají jednu až osm komponent (to znamená singletony prostřednictvím osmičků). Přestože neexistuje žádný praktický limit počtu součástí, které by mohla mít řazená kolekce členů, pomocné metody nejsou k dispozici k vytvoření řazené kolekce členů s devíti nebo více komponentami. Chcete-li vytvořit takovou řazenou kolekci Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> členů, je nutné volat konstruktor.

Poznámka:

Další informace a příklady, které používají řazené kolekce členů, najdete v dokumentaci k jednotlivým typům řazených kolekcí členů v rozhraní .NET Framework. Jsou uvedené v části Viz také na konci tohoto tématu.

Metody

Name	Description
Create<T1,T2,T3,T4,T5,T6,T7,T8>(T1, T2, T3, T4, T5, T6, T7, T8)	Vytvoří novou 8řazenou kolekci členů nebo osmičkovou kolekci.
Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)	Vytvoří novou řazenou kolekci řazených kolekcí členů nebo septuple.
Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)	Vytvoří novou kolekci členů 6 členů nebo sextuple.
Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)	Vytvoří novou kolekci 5 členů nebo quintuple.
Create<T1,T2,T3,T4>(T1, T2, T3, T4)	Vytvoří novou řazenou kolekci 4 členů nebo čtyřnásobnou kolekci členů.
Create<T1,T2,T3>(T1, T2, T3)	Vytvoří novou kolekci řazených kolekcí členů nebo trojitou kolekci členů.
Create<T1,T2>(T1, T2)	Vytvoří novou řazenou kolekci členů nebo dvojici.
Create<T1>(T1)	Vytvoří novou kolekci 1 členů nebo singleton.

Viz také

• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• 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>