Tuple Klasse

Definition

public ref class Tuple abstract sealed

public static class Tuple

type Tuple = class

Public Class Tuple

Vererbung

Object

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 Abfolge von Elementen. Ein Beispiel für ein Tupel ist eine Datenstruktur mit drei Elementen (als 3-Tupel oder Dreifach bezeichnet), 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. Das .NET Framework unterstützt Tupel direkt mit einem bis sieben Elementen. Darüber hinaus können Sie Tupel von 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:

• So stellen Sie eine einzelne Datenmenge dar. Beispielsweise kann ein Tupel einen Datenbankdatensatz darstellen, und seine Komponenten können einzelne Felder des Datensatzes darstellen.

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

• So geben Sie mehrere Werte aus 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 beim Startvorgang 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 selbst stellt kein Tupel dar. Stattdessen handelt es sich um eine Klasse, die statische Methoden zum Erstellen von Instanzen der Tupeltypen bereitstellt, die von .NET Framework unterstützt werden. Es stellt Hilfsmethoden bereit, die Sie zum Instanziieren von Tupelobjekten aufrufen können, ohne den Typ jeder Tupelkomponente explizit angeben zu müssen.

Obwohl Sie eine Instanz einer Tupelklasse erstellen können, indem Sie den Klassenkonstruktor aufrufen, kann der code hierfür umständlich sein. Im folgenden Beispiel wird ein Klassenkonstruktor verwendet, um ein 7-Tupel oder ein Septuple zu erstellen, das Für jede Zählung von 1950 bis 2000 Bevölkerungsdaten für New York City 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 im folgenden Beispiel gezeigt.

// 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, die aus einer bis acht Komponenten bestehen (d. h. Singletons durch Oktuples). Obwohl es keinen praktischen Grenzwert für die Anzahl der Komponenten gibt, die ein Tupel aufweisen kann, stehen Hilfsmethoden nicht 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.

Weitere Informationen

• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• Tuple<T1,T2,T3,T4>
• Tuple<T1,T2,T3,T4,T5>
• Tuple<T1,T2,T3,T4,T5,T6>
• Tuple<T1,T2,T3,T4,T5,T6,T7>
• Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>