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

Definition

Namespace:

System

Assemblys:

netstandard.dll, System.Runtime.dll

Quelle:

Tuple.cs

Stellt ein n-Tupel dar, wobei n 8 oder größer ist.

generic <typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7, typename TRest>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple

public class Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple

type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6, 'T7, 'Rest> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple

Public Class Tuple(Of T1, T2, T3, T4, T5, T6, T7, TRest)
Implements IComparable, IStructuralComparable, IStructuralEquatable, ITuple

Typparameter

T1

Der Typ der ersten Komponente des Tupels.

T2

Der Typ der zweiten Komponente des Tupels.

T3

Der Typ der dritten Komponente des Tupels.

T4

Der Typ der vierten Komponente des Tupels.

T5

Der Typ der fünften Komponente des Tupels.

T6

Der Typ der sechsten Komponente des Tupels.

T7

Der Typ der siebten Komponente des Tupels.

TRest

Jedes generische Tuple Objekt, das die Typen der verbleibenden Komponenten des Tupels definiert.

Vererbung

Object

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

Implementiert

IStructuralComparable IStructuralEquatable IComparable ITuple

Hinweise

Ein Tupel ist eine Datenstruktur mit einer bestimmten Anzahl und Abfolge von Werten. Die Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Klasse stellt ein n-Tupel dar, das acht oder mehr Komponenten enthält.

Sie können ein Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt mit genau acht Komponenten instanziieren, indem Sie die statische Tuple.Create Methode aufrufen. Im folgenden Beispiel wird ein 8-Tupel (Oktuple) erstellt, das Primzahlen enthält, die kleiner als 20 sind. Beachten Sie, dass die Typreferenz verwendet wird, um den Typ der einzelnen Komponenten zu bestimmen.

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

Sie können ein n-Tupel-Objekt auch mit acht oder mehr Komponenten instanziieren, indem Sie den Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Konstruktor aufrufen. Im folgenden Beispiel wird der Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Konstruktor verwendet, um ein 8-Tupel zu erstellen, das dem im vorherigen Beispiel erstellten Tupel entspricht.

var primes = new Tuple<Int32, Int32, Int32, Int32, Int32, Int32, Int32,  
             Tuple<Int32>> (2, 3, 5, 7, 11, 13, 17, new Tuple<Int32>(19));

let primes = new Tuple<Int32, Int32, Int32, Int32, Int32, Int32, Int32,  
               Tuple<Int32>> (2, 3, 5, 7, 11, 13, 17, new Tuple<Int32>(19))

Dim primes = New Tuple(Of Int32, Int32, Int32, Int32, Int32, Int32, Int32, _ 
             Tuple(Of Int32))(2, 3, 5, 7, 11, 13, 17, New Tuple(Of Int32)(19))

Hinweis

Um ein n-Tupel mit neun oder mehr Komponenten zu erstellen, müssen Sie den Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Konstruktor aufrufen. Die statischen Factorymethoden der Tuple Klasse unterstützen die Erstellung von Tuple Objekten mit mehr als acht Komponenten nicht.

Zum Instanziieren eines n-Tupels mit acht oder mehr Komponenten mit dem Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Konstruktor geben Sie ein generisches Tuple Objekt als rest Parameter an, um die achte bis nth-Komponentendes Tupels zu definieren. Durch das Verschachteln generischer Tuple Objekte auf diese Weise können Sie ein Tupel erstellen, das keine praktische Einschränkung für die Anzahl seiner Komponenten hat.

Im folgenden Beispiel wird ein 17-Tupel erstellt, das Bevölkerungsdaten für die Stadt Detroit, Michigan, für jede nationale Zählung von 1860 bis 2000 enthält. Die erste Komponente des Tupels ist der Stadtname. Die zweite Komponente ist das Startdatum der Datenreihe, und die dritte Komponente ist die Grundpopulation am Anfangsdatum. Jede nachfolgende Komponente stellt die Population in Intervallen von zehn Jahren bereit. Das 17-Tupel wird durch Schachteln eines Tuple<T1,T2,T3> Objekts innerhalb eines Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts erstellt. (Das heißt, das Tuple<T1,T2,T3> Objekt wird als Wert des rest Parameters im Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Klassenkonstruktor angegeben.) Dieses Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt ist wiederum in einem äußeren Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt geschachtelt. (Das heißt, das Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt wird als Wert des rest Parameters im Klassenkonstruktor des äußeren Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts angegeben.)

var from1980 = Tuple.Create(1203339, 1027974, 951270);
var from1910 = new Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>> 
    (465766, 993078, 1568622, 1623452, 1849568, 1670144, 1511462, from1980);
var population = new Tuple<string, int, int, int, int, int, int,
    Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>>> 
    ("Detroit", 1860, 45619, 79577, 116340, 205876, 285704, from1910);

let from1980 = Tuple.Create(1203339, 1027974, 951270)
let from1910 = new Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>>(465766, 993078, 1568622, 1623452, 1849568, 1670144, 1511462, from1980)
let population = new Tuple<string, int, int, int, int, int, int, Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>>>("Detroit", 1860, 45619, 79577, 116340, 205876, 285704, from1910)

Dim from1980 = Tuple.Create(1203339, 1027974, 951270)
Dim from1910 As New Tuple(Of Integer, Integer, Integer, Integer, Integer, Integer, Integer, _
    Tuple(Of Integer, Integer, Integer)) _
    (465766, 993078, 1568622, 1623452, 1849568, 1670144, 1511462, from1980)
Dim population As New Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer, _ 
    Tuple(Of Integer, Integer, Integer, Integer, Integer, Integer, Integer, Tuple(Of Integer, Integer, Integer))) _
    ("Detroit", 1860, 45619, 79577, 116340, 205876, 285704, from1910)

Sie können den Wert der ersten sieben Komponenten des Tupels abrufen, indem Sie die schreibgeschützten Item1, , Item3Item2, Item4Item5, , Item6und Item7 Instanzeigenschaften verwenden. Alle zusätzlichen Komponenten sind geschachtelt und können aus der Rest Eigenschaft abgerufen werden. Im vorherigen Beispiel rufen die Item1 Durchgangseigenschaften Item7 die ersten bis siebten Komponenten des Tupels ab. Die achte bis vierzehnten Komponenten sind im Tupel enthalten, das auf der zweiten Ebene geschachtelt ist und durch die Durcheigenschaften Rest.Item1Rest.Item7 dargestellt wird. Die fünfzehnten bis 17. Komponenten sind im Tupel enthalten, das auf der dritten Ebene geschachtelt ist und durch die Rest.Rest.Item1 eigenschaften Rest.Rest.Item3 dargestellt werden.

Tupel werden häufig auf vier verschiedene 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 ohne Verwendung von out Parametern (in C#) oder ByRef Parametern (in Visual Basic) zurück. Im vorherigen Beispiel werden beispielsweise die berechneten Statistiken zusammen mit dem Stadtnamen in einem Tuple<T1,T2,T3,T4,T5,T6,T7> Objekt zurückgegeben.

• 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 Start ausführt. Wenn Sie ein Tuple<T1,T2,T3,T4,T5,T6,T7> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit sieben Datenelementen bereitstellen.

Konstruktoren

Name	Beschreibung
Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>(T1, T2, T3, T4, T5, T6, T7, TRest)	Initialisiert eine neue Instanz der Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>-Klasse.

Eigenschaften

Name	Beschreibung
Item1	Ruft den Wert der ersten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item2	Ruft den Wert der zweiten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item3	Ruft den Wert der dritten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item4	Ruft den Wert der vierten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item5	Ruft den Wert der fünften Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item6	Ruft den Wert der sechsten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Item7	Ruft den Wert der siebten Komponente des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.
Rest	Ruft die verbleibenden Komponenten des aktuellen Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekts ab.

Methoden

Name	Beschreibung
Equals(Object)	Gibt einen Wert zurück, der angibt, ob das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt einem angegebenen Objekt entspricht.
GetHashCode()	Berechnet den Hashcode für das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt.
GetType()	Ruft die Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie der aktuellen Object. (Geerbt von Object)
ToString()	Gibt eine Zeichenfolge zurück, die den Wert dieser Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Instanz darstellt.

Explizite Schnittstellenimplementierungen

Name	Beschreibung
IComparable.CompareTo(Object)	Vergleicht das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob das aktuelle Objekt vor, nach oder in derselben Position wie das angegebene Objekt in der Sortierreihenfolge liegt.
IStructuralComparable.CompareTo(Object, IComparer)	Vergleicht das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt mit einem angegebenen Objekt mithilfe eines angegebenen Vergleichs und gibt eine ganze Zahl zurück, die angibt, ob das aktuelle Objekt vor, nach oder in derselben Position wie das angegebene Objekt in der Sortierreihenfolge liegt.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Gibt einen Wert zurück, der angibt, ob das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt einem angegebenen Objekt entspricht, basierend auf einer angegebenen Vergleichsmethode.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Berechnet den Hashcode für das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> Objekt mithilfe einer angegebenen Berechnungsmethode.
ITuple.Item[Int32]	Ruft den Wert des angegebenen Tuple Elements ab.
ITuple.Length	Ruft die Anzahl der Elemente in der Tuple.

Weitere Informationen

• Tuple
• 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>