Tuple Tuple Tuple Tuple Class

Definition

Stellt statische Methoden zum Erstellen von Tupelobjekten bereit. Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Inheritance
TupleTupleTupleTuple

Examples

Das folgende Beispiel erstellt einen 8-Tupel (Oktupel), der Primzahlen enthält, die weniger als 20 sind.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

Remarks

Ein Tupel ist eine Datenstruktur, die eine bestimmte Anzahl und Reihenfolge der Elemente verfügt.A tuple is a data structure that has a specific number and sequence of elements. Ein Beispiel für ein Tupel ist eine Datenstruktur mit drei Elementen (bekannt als ein 3-Tupel bzw. Tripel), die verwendet wird, um einen Bezeichner, z. B. den Namen einer Person in das erste Element, ein Jahr in das zweite Element, und der Person Einkommen für dieses Jahr in das dritte Element zu speichern.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 unterstützt direkt Tupel mit 1 bis sieben Elemente.The .NET Framework directly supports tuples with one to seven elements. Darüber hinaus können Sie Tupel mit acht oder mehr Elemente einer erstellen, indem die Verschachtelung von Tupelobjekten in der Rest Eigenschaft eine Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt.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.

Tupel werden häufig auf vier Arten verwendet:Tuples are commonly used in four ways:

  • Um einen Satz von Daten darzustellen.To represent a single set of data. Z. B. ein Tupels kann einen Datenbank-Datensatz darstellen, und seine Komponenten können einzelne Felder des Datensatzes darstellen.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • Einfacher Zugriff auf sowie die Bearbeitung eines Datensatzes zu ermöglichen.To provide easy access to, and manipulation of, a data set.

  • Mehrere Werte aus einer Methode zurückgeben, ohne out Parameter (in c#) oder ByRef Parameter (in Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Um mehrere Werte an eine Methode über einen einzelnen Parameter übergeben.To pass multiple values to a method through a single parameter. Z. B. die Thread.Start(Object) Methode verfügt über einen einzelnen Parameter, mit dem Sie einen Wert an die Methode angeben können, die der Thread beim Start ausgeführt wird.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. Wenn Sie angeben, ein Tuple<T1,T2,T3> Objekt als Methodenargument, können Sie die Startroutine mit drei Elementen der Daten angeben.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.

Die Tuple Klasse stellt keinen selbst dar. ein Tupel.The Tuple class does not itself represent a tuple. Stattdessen ist es eine Klasse, die eine statische Methoden zum Erstellen von Instanzen der die Tuple-Typen, die von .NET Framework unterstützt werden.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. Es stellt Hilfsmethoden bereit, die Sie aufrufen können, um Tupelobjekte zu instanziieren, ohne den Typ der einzelnen Komponenten für Tupel explizit angeben zu müssen.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

Obwohl Sie eine Instanz einer Klasse Tupel durch Aufruf ihres Klassenkonstruktors erstellen können, kann der Code dazu aufwendig sein.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. Im folgenden Beispiel wird einen Klassenkonstruktor, um ein 7-Tupel zu erstellen oder Septupel, die Bevölkerungsdaten für New York City für jede Erhebung von 1950 bis 2000 enthält.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

Erstellen das gleiche Tupelobjekt mit einer Hilfsmethode ist geradliniger, wie im folgenden Beispiel gezeigt.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

Die Create Hilfsmethoden direkte Unterstützung für die Erstellung von Tupelobjekte, die von einer bis zu acht Komponenten (d. h. Singletons bis Oktupel) verfügen.The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). Aber es gibt praktisch keine Begrenzung hinsichtlich der Anzahl der Komponenten kann ein Tupel: Helper-Methoden sind nicht verfügbar, um ein Tupel mit neun oder weitere Komponenten zu erstellen.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. Um solche ein Tupel zu erstellen, rufen Sie die Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> 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.

Hinweis

Weitere Informationen und Beispiele für die Verwendung von Tupeln, finden Sie unter der Dokumentation für die einzelnen Tuple-Typen in .NET Framework.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Diese werden in den Abschnitt "Siehe auch" am Ende dieses Themas aufgeführt.These are listed in the See Also section at the end of this topic.

Methods

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

Erstellt ein neues 8-Tupel bzw. Oktupel. Creates a new 8-tuple, or octuple.

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

Erstellt ein neues 7-Tupel bzw. Septupel. Creates a new 7-tuple, or septuple.

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

Erstellt ein neues 6-Tupel bzw. Sextupel. Creates a new 6-tuple, or sextuple.

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

Erstellt ein neues 5-Tupel bzw. Quintupel. Creates a new 5-tuple, or quintuple.

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

Erstellt ein neues 4-Tupel bzw. Quadrupel. Creates a new 4-tuple, or quadruple.

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

Erstellt ein neues 3-Tupel bzw. Tripel. Creates a new 3-tuple, or triple.

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

Erstellt ein neues 2-Tupel bzw. Paar. Creates a new 2-tuple, or pair.

Create<T1>(T1) Create<T1>(T1) Create<T1>(T1) Create<T1>(T1)

Erstellt ein neues 1-Tupel bzw. Singleton. Creates a new 1-tuple, or singleton.

Applies to

See Also