Tuple Klasse

Definition

Stellt statische Methoden zum Erstellen von Tupelobjekten bereit.

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

Beispiele

Im folgenden Beispiel wird ein 8-Tupel (Oktuple) erstellt, das Primzahlen enthält, die kleiner als 20 sind.

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

Hinweise

Ein Tupel ist eine Datenstruktur mit einer bestimmten Anzahl und Sequenz von Elementen. Ein Beispiel für ein Tupel ist eine Datenstruktur mit drei Elementen (bekannt als 3-Tupel oder Triple), die verwendet wird, um einen Bezeichner wie den Namen einer Person im ersten Element, ein Jahr im zweiten Element und das Einkommen der Person für dieses Jahr im dritten Element zu speichern. Die .NET Framework unterstützt Tupel mit einem bis sieben Elementen direkt. Darüber hinaus können Sie Tupel mit acht oder mehr Elementen erstellen, indem Sie Tupelobjekte in der Rest -Eigenschaft eines Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts verschachteln.

Tupel werden häufig auf vier Arten verwendet:

  • Um einen einzelnen Satz von Daten darzustellen. Ein Tupel kann beispielsweise einen Datenbankdatensatz darstellen, und seine Komponenten können einzelne Felder des Datensatzes darstellen.

  • Um einen einfachen Zugriff auf und die Bearbeitung eines Datasets zu ermöglichen.

  • So geben Sie mehrere Werte von einer Methode zurück, ohne Parameter (in C#) oder ByRef Parametern (in Visual Basic) zu verwendenout.

  • So übergeben Sie mehrere Werte über einen einzelnen Parameter an eine Methode. Die Methode verfügt beispielsweise über einen einzelnen Parameter, Thread.Start(Object) mit dem Sie einen Wert für die Methode angeben können, die der Thread zur Startzeit ausführt. Wenn Sie ein Tuple<T1,T2,T3> -Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit drei Datenelementen bereitstellen.

Die Tuple Klasse stellt selbst kein Tupel dar. Stattdessen handelt es sich um eine Klasse, die statische Methoden zum Erstellen von Instanzen der Tupeltypen bereitstellt, die vom .NET Framework unterstützt werden. Sie bietet Hilfsmethoden, die Sie aufrufen können, um Tupelobjekte zu instanziieren, ohne den Typ der einzelnen Tupelkomponenten explizit angeben zu müssen.

Obwohl Sie eine Instanz einer Tupelklasse erstellen können, indem Sie ihren Klassenkonstruktor aufrufen, kann der entsprechende Code umständlich sein. Im folgenden Beispiel wird ein Klassenkonstruktor verwendet, um ein 7-Tupel oder Septuple zu erstellen, das Einwohnerdaten für New York City für jede Volkszählung zwischen 1950 und 2000 enthält.

// 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

Das Erstellen desselben Tupelobjekts mithilfe einer Hilfsmethode ist einfacher, wie das folgende Beispiel zeigt.

// 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

Die Create Hilfsmethoden unterstützen direkt die Erstellung von Tupelobjekten mit einer bis acht Komponenten (also Singletons über Oktuples). Obwohl es keine praktische Begrenzung für die Anzahl der Komponenten gibt, die ein Tupel aufweisen kann, stehen keine Hilfsmethoden zur Verfügung, um ein Tupel mit neun oder mehr Komponenten zu erstellen. Um ein solches Tupel zu erstellen, müssen Sie den Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Konstruktor aufrufen.

Hinweis

Weitere Informationen und Beispiele, die Tupel verwenden, finden Sie in der Dokumentation zu den einzelnen Tupeltypen im .NET Framework. Diese sind im Abschnitt Siehe auch am Ende dieses Themas aufgeführt.

Methoden

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

Erstellt ein neues 8-Tupel bzw. Oktupel.

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

Erstellt ein neues 7-Tupel bzw. Septupel.

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

Erstellt ein neues 6-Tupel bzw. Sextupel.

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

Erstellt ein neues 5-Tupel bzw. Quintupel.

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

Erstellt ein neues 4-Tupel bzw. Quadrupel.

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

Erstellt ein neues 3-Tupel bzw. Tripel.

Create<T1,T2>(T1, T2)

Erstellt ein neues 2-Tupel bzw. Paar.

Create<T1>(T1)

Erstellt ein neues 1-Tupel bzw. Singleton.

Gilt für:

Weitere Informationen