Tuple Třída

  • Reference

Definice

Obor názvů:
System
Sestavení:
System.Runtime.dll
Sestavení:
mscorlib.dll
Sestavení:
netstandard.dll
Zdroj:
Tuple.cs
Zdroj:
Tuple.cs
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ří osmičkovou řazenou kolekci 8 členů, která obsahuje prvočísá čísla 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 3-řazená kolekce členů nebo trojice), 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ů do Rest vlastnosti objektu Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> .

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

  • K reprezentaci jediné datové sady. Například řazená kolekce členů může představovat záznam v databázi a její součásti mohou představovat jednotlivá pole záznamu.

  • K zajištění snadného přístupu k datové sadě a manipulace s datovou sadou.

  • Vrácení více hodnot z metody bez použití out parametrů (v jazyce C#) nebo ByRef parametrů (v jazyce Visual Basic).

  • Pro předání více hodnot metodě prostřednictvím jediného parametru. Například metoda má jeden parametr, Thread.Start(Object) který umožňuje zadat jednu hodnotu pro metodu, kterou vlákno spustí při spuštění. Pokud jako argument metody zadáte Tuple<T1,T2,T3> objekt, můžete zadat rutinu spouštění 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ů bez nutnosti explicitně určovat typ každé součásti řazené kolekce členů.

Ačkoli můžete vytvořit instanci třídy řazené kolekce členů voláním 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í řazené kolekce se 7 řazenou kolekcí nebo septuple, která obsahuje data o populaci pro New York City pro každý sčítání lidu od roku 1950 do roku 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

Pomocné Create metody přímo podporují vytváření objektů řazené kolekce členů, které mají jednu až osm komponent (to znamená singletony prostřednictvím oktů). I když neexistuje žádný praktický limit počtu komponent, které může mít řazená kolekce členů, pomocné metody nejsou k dispozici pro 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. Ty jsou uvedené v části Viz také na konci tohoto tématu.

Metody

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

Vytvoří novou osmičkovou řazenou kolekci členů.
Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

Vytvoří novou řazenou kolekci 7 členů neboli septuple.
Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)

Vytvoří novou řazenou kolekci 6 členů neboli sextuple.
Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

Vytvoří novou řazenou kolekci s pěti řazenou kolekcí členů.
Create<T1,T2,T3,T4>(T1, T2, T3, T4)

Vytvoří novou řazenou kolekci se 4 řazenou kolekcí členů nebo čtyřnásobnou.
Create<T1,T2,T3>(T1, T2, T3)

Vytvoří novou řazenou kolekci se třemi řazemi.
Create<T1,T2>(T1, T2)

Vytvoří novou řazenou kolekci se 2 řazenou kolekcí členů.
Create<T1>(T1)

Vytvoří novou řazenou kolekci řazených kolekcí členů neboli singleton.

Platí pro

Viz také