Tuple Klasa

Definicja

Zapewnia statyczne metody tworzenia obiektów krotki.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Dziedziczenie
Tuple

Przykłady

Poniższy przykład tworzy 8-krotkę (Octuple), która zawiera liczby podstawowe, które są mniejsze niż 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

Uwagi

Krotka jest strukturą danych, która ma określoną liczbę i sekwencję elementów.A tuple is a data structure that has a specific number and sequence of elements. Przykładem krotki jest struktura danych z trzema elementami (nazywana 3-krotką lub potrójną), która jest używana do przechowywania identyfikatora, takiego jak nazwisko osoby w pierwszym elemencie, rok w drugim elemencie oraz dochód osoby dla tego roku w trzecim elemencie.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 bezpośrednio obsługuje krotki z jednym do siedmiu elementów.The .NET Framework directly supports tuples with one to seven elements. Ponadto można tworzyć krotki składające się z ośmiu lub więcej elementów przez zagnieżdżanie obiektów krotek we Rest właściwości Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> obiektu.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.

Krotki są często używane na cztery sposoby:Tuples are commonly used in four ways:

  • Reprezentowanie jednego zestawu danych.To represent a single set of data. Na przykład spójna kolekcja może reprezentować rekord bazy danych, a jej składniki mogą reprezentować poszczególne pola rekordu.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • Zapewnienie łatwego dostępu do zestawu danych i możliwości wykonywania w nim różnych operacji.To provide easy access to, and manipulation of, a data set.

  • Aby zwrócić wiele wartości z metody bez używania out parametrów (w języku C#) lub ByRef parametrów (w Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Przekazywanie wielu wartości do metody za pomocą jednego parametru.To pass multiple values to a method through a single parameter. Na przykład Thread.Start(Object) Metoda ma jeden parametr, który umożliwia podawanie jednej wartości metodzie wykonywanej przez wątek w czasie uruchamiania.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. W przypadku podania Tuple<T1,T2,T3> obiektu jako argumentu metody można dostarczyć procedurę uruchamiania wątku z trzema elementami danych.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.

TupleKlasa nie reprezentuje samej krotki.The Tuple class does not itself represent a tuple. Zamiast tego jest klasą, która udostępnia statyczne metody tworzenia wystąpień typów krotek obsługiwanych przez .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. Dostarcza metody pomocnika, które można wywołać w celu wystąpienia obiektów krotki bez konieczności jawnego określania typu każdego składnika krotki.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

Chociaż można utworzyć wystąpienie klasy krotki przez wywołanie jej konstruktora klasy, kod do wykonania może być nieskomplikowany.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. W poniższym przykładzie zastosowano konstruktora klasy do utworzenia kolekcji 7-lub septuple zawierającej dane populacji dla każdego spisu 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

Tworzenie tego samego obiektu krotki przy użyciu metody pomocnika jest bardziej proste, jak pokazano w poniższym przykładzie.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

CreateMetody pomocnika bezpośrednio obsługują tworzenie obiektów krotek, które pochodzą z jednego do ośmiu składników (to oznacza, pojedyncze elementy przez octuples).The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). Chociaż nie ma praktycznego limitu liczby składników, które może mieć krotka, metody pomocnicze nie są dostępne do utworzenia krotki z dziewięcioma lub więcej składników.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. Aby utworzyć taką spójną krotkę, należy wywołać Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> konstruktora.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.

Uwaga

Aby uzyskać dodatkowe informacje i przykłady, które używają krotek, zapoznaj się z dokumentacją poszczególnych typów krotek w .NET Framework.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Są one wymienione w sekcji Zobacz też na końcu tego tematu.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)

Tworzy nową 8-krotek lub Octuple.Creates a new 8-tuple, or octuple.

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

Tworzy nową 7-krotek lub septuple.Creates a new 7-tuple, or septuple.

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

Tworzy nową 6-krotek lub sextuple.Creates a new 6-tuple, or sextuple.

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

Tworzy nową 5-krotek lub Quintuple.Creates a new 5-tuple, or quintuple.

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

Tworzy nową 4-krotek lub czterokrotnie.Creates a new 4-tuple, or quadruple.

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

Tworzy nową 3-krotek lub trzykrotnie.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2)

Tworzy nową parę 2-krotek lub.Creates a new 2-tuple, or pair.

Create<T1>(T1)

Tworzy nową 1-krotkę lub pojedynczą.Creates a new 1-tuple, or singleton.

Dotyczy

Zobacz też