Tuple Třída

Definice

Poskytuje statické metody pro vytváření objektů řazené kolekce členů.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Dědičnost
Tuple

Příklady

Následující příklad vytvoří 8-Tuple (octuple) obsahující prvočísla, která jsou menší než 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

Poznámky

Řazená kolekce členů je datová struktura, která má konkrétní číslo a sekvenci prvků.A tuple is a data structure that has a specific number and sequence of elements. Příkladem řazené kolekce členů je datová struktura se třemi prvky (označované jako 3-Tuple nebo trojité), která se používá k uložení identifikátoru, jako je například jméno osoby v prvním prvku, rok v druhém prvku a příjem osoby za tento rok v třetím prvku.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 přímo podporuje řazené kolekce členů s jedním až sedmi prvky.The .NET Framework directly supports tuples with one to seven elements. Kromě toho můžete vytvořit řazené kolekce členů osmi nebo více prvků vnořením objektů řazené kolekce členů do Rest vlastnosti Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> objektu.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.

Řazené kolekce členů se běžně používají čtyřmi způsoby:Tuples are commonly used in four ways:

  • K reprezentaci jediné datové sady.To represent a single set of data. 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.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • K zajištění snadného přístupu k datové sadě a manipulace s datovou sadou.To provide easy access to, and manipulation of, a data set.

  • Chcete-li vrátit více hodnot z metody bez out použití parametrů ( C#v) ByRef nebo parametrů (v Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Pro předání více hodnot metodě prostřednictvím jediného parametru.To pass multiple values to a method through a single parameter. Například Thread.Start(Object) metoda má jeden parametr, který umožňuje zadání jedné hodnoty metodě, kterou vlákno provádí při spuštění.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. Pokud zadáte Tuple<T1,T2,T3> objekt jako argument metody, můžete do spouštěcí rutiny vlákna dodat tři položky dat.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.

Tuple Třída sám nereprezentuje řazenou kolekci členů.The Tuple class does not itself represent a tuple. Místo toho je třída, která poskytuje statické metody pro vytváření instancí typů řazené kolekce členů, které jsou podporovány .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. Poskytuje pomocné metody, které lze volat pro vytvoření instance objektů řazené kolekce členů bez nutnosti explicitně zadat typ každé součásti řazené kolekce členů.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

I když můžete vytvořit instanci třídy řazené kolekce členů voláním svého konstruktoru třídy, kód, který to udělá, může být nenáročný.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. Následující příklad používá konstruktor třídy k vytvoření 7-tuple nebo septuple, který obsahuje data populace pro New York City pro každé sčítání od 1950 do 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

Vytvoření stejného objektu řazené kolekce členů pomocí pomocné metody je jednodušší, jak ukazuje následující příklad.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

Create Pomocné metody přímo podporují vytváření objektů řazené kolekce členů, které mají jednu až osm komponent (tj. typu Singleton prostřednictvím octuples).The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). I když není k dispozici žádné praktické omezení počtu komponent, které mohou být řazené kolekce členů, neexistují pomocné metody k vytvoření řazené kolekce členů s devíti nebo více komponentami.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. Chcete-li vytvořit takovou řazenou kolekci členů, Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> je nutné volat konstruktor.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.

Poznámka

Další informace a příklady, které používají řazené kolekce členů, najdete v dokumentaci k jednotlivým typům řazené kolekce členů v .NET Framework.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Tyto informace jsou uvedeny v části Viz také na konci tohoto tématu.These are listed in the See Also section at the end of this topic.

Metody

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

Vytvoří nové 8-řazené kolekce členů nebo octuple.Creates a new 8-tuple, or octuple.

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

Vytvoří nové 7 – tuple nebo septuple.Creates a new 7-tuple, or septuple.

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

Vytvoří novou 6 – řazenou kolekci členů nebo sextuple.Creates a new 6-tuple, or sextuple.

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

Vytvoří nový 5-tuple nebo quintuple.Creates a new 5-tuple, or quintuple.

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

Vytvoří novou 4-řazenou kolekci členů nebo čtyřnásobnou hodnotu.Creates a new 4-tuple, or quadruple.

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

Vytvoří nové 3 – řazené kolekce členů nebo tři.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2)

Vytvoří novou dvojici dvou členů nebo párů.Creates a new 2-tuple, or pair.

Create<T1>(T1)

Vytvoří nový typ 1-Tuple nebo singleton.Creates a new 1-tuple, or singleton.

Platí pro

Viz také