Tuple<T1,T2,T3,T4> Klasse

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Stellt ein 4-Tupel (Quadrupel) dar.

C#

public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

C#

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

C#

[System.Serializable]
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

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.

Vererbung

Object

Tuple<T1,T2,T3,T4>

Attribute

SerializableAttribute

Implementiert

IStructuralComparable IStructuralEquatable IComparable ITuple

Hinweise

Ein Tupel ist eine Datenstruktur mit einer bestimmten Anzahl und Reihenfolge von Werten. Die Tuple<T1,T2,T3,T4> Klasse stellt ein 4-Tupel oder vierfache Klammer dar, das ein Tupel mit vier Komponenten ist.

Sie können ein Tuple<T1,T2,T3,T4> Objekt instanziieren, indem Sie entweder den Tuple<T1,T2,T3,T4> Konstruktor oder die statische Tuple.Create<T1,T2,T3,T4>(T1, T2, T3, T4) Methode aufrufen. Sie können den Wert der Komponenten des Tupels mithilfe der schreibgeschützten Item1, Item2, , Item3und Item4 Instanzeigenschaften abrufen.

Tuples werden häufig auf vier verschiedene Arten verwendet:

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

• Um einfachen Zugriff auf und Manipulation von Datensätzen zu ermöglichen. Im folgenden Beispiel wird ein Array von Tuple<T1,T2,T3,T4> Objekten definiert, das die Namen von Baseball-Pitchern, die Anzahl der Aufschläge und die Anzahl der verdienten Läufe (Läufe, die ohne Feldfehler bewertet wurden) und Treffer, die sie aufgegeben haben. Das Array wird an die ComputeStatistics Methode übergeben, die den Ertragswert jedes Pitchers berechnet (die durchschnittliche Anzahl von Läufen, die in einem Neun-Inning-Spiel angegeben wurden) und die durchschnittliche Anzahl von Treffern pro Inning. Die Methode verwendet auch diese beiden Mittelwerte, um einen hypothetischen Effektivitätsdurchschnitt zu berechnen.

  C#

  using System;
  using System.Collections.Generic;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, decimal, int, int>[] pitchers  =  
             { Tuple.Create("McHale, Joe", 240.1m, 221, 96),
               Tuple.Create("Paul, Dave", 233.1m, 231, 84), 
               Tuple.Create("Williams, Mike", 193.2m, 183, 86),
               Tuple.Create("Blair, Jack", 168.1m, 146, 65), 
               Tuple.Create("Henry, Walt", 140.1m, 96, 30),
               Tuple.Create("Lee, Adam", 137.2m, 109, 45),
               Tuple.Create("Rohr, Don", 101.0m, 110, 42) };
        Tuple<string, double, double, double>[] results= ComputeStatistics(pitchers);
  
        // Display the results.
        Console.WriteLine("{0,-20} {1,9} {2,11} {3,15}\n", 
                          "Pitcher", "ERA", "Hits/Inn.", "Effectiveness");
        foreach (var result in results)
           Console.WriteLine("{0,-20} {1,9:F2} {2,11:F2} {3,15:F2}",  
                          result.Item1, result.Item2, result.Item3, result.Item4);
     }
  
     private static Tuple<string, double, double, double>[] ComputeStatistics(Tuple<string, decimal, int, int>[] pitchers)
     {    
        var list = new List<Tuple<string, double, double, double>>();
        Tuple<string, double, double, double> result;
  
        foreach (var pitcher in pitchers)
        {
           // Decimal portion of innings pitched represents 1/3 of an inning
           double innings = (double) Math.Truncate(pitcher.Item2);
           innings = innings + (((double)pitcher.Item2 - innings) * .33);
           
           double ERA = pitcher.Item4/innings * 9;
           double hitsPerInning = pitcher.Item3/innings;
           double EI = (ERA * 2 + hitsPerInning * 9)/3;
           result = new Tuple<string, double, double, double>
                             (pitcher.Item1, ERA, hitsPerInning, EI);
           list.Add(result);
        }
        return list.ToArray();
     }
  }
  // The example displays the following output;
  //       Pitcher                    ERA   Hits/Inn.   Effectiveness
  //       
  //       McHale, Joe               3.60        0.92            5.16
  //       Paul, Dave                3.24        0.99            5.14
  //       Williams, Mike            4.01        0.95            5.52
  //       Blair, Jack               3.48        0.87            4.93
  //       Henry, Walt               1.93        0.69            3.34
  //       Lee, Adam                 2.95        0.80            4.36
  //       Rohr, Don                 3.74        1.09            5.76
  

• Um mehrere Werte aus einer Methode zurückzugeben, ohne parameter (in C#) oder ByRef Parametern (in Visual Basic) zu verwendenout. Das vorherige Beispiel gibt beispielsweise seine berechneten Statistiken zusammen mit dem Namen des Pitchers in einem Array von Tuple<T1,T2,T3,T4> Objekten zurück.

• So übergeben Sie mehrere Werte an eine Methode über einen einzelnen Parameter. Die Methode verfügt beispielsweise Thread.Start(Object) über einen einzelnen Parameter, 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> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit vier Datenelementen angeben.

Konstruktoren

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

Initialisiert eine neue Instanz der Tuple<T1,T2,T3,T4>-Klasse.

Eigenschaften

Item1	Ruft den Wert der ersten Komponente des aktuellen Tuple<T1,T2,T3,T4>-Objekts ab.
Item2	Ruft den Wert der zweiten Komponente des aktuellen Tuple<T1,T2,T3,T4>-Objekts ab.
Item3	Ruft den Wert der dritten Komponente des aktuellen Tuple<T1,T2,T3,T4>-Objekts ab.
Item4	Ruft den Wert der vierten Komponente des aktuellen Tuple<T1,T2,T3,T4>-Objekts ab.

Methoden

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

Explizite Schnittstellenimplementierungen

IComparable.CompareTo(Object)	Vergleicht das aktuelle Tuple<T1,T2,T3,T4>-Objekt mit einem angegebenen Objekt und gibt eine Ganzzahl zurück, die darauf hinweist, ob sich das aktuelle Objekt in der Sortierreihenfolge vor oder hinter dem angegebenen Objekt oder an der gleichen Position befindet.
IStructuralComparable.CompareTo(Object, IComparer)	Vergleicht das aktuelle Tuple<T1,T2,T3,T4>-Objekt anhand eines angegebenen Vergleichs mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob sich das aktuelle Element in der Sortierreihenfolge vor dem angegebenen Element, dahinter oder an derselben Position befindet.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Gibt einen Wert zurück, der auf Grundlage einer angegebenen Vergleichsmethode angibt, ob das aktuelle Tuple<T1,T2,T3,T4>-Objekt gleich einem angegebenen Objekt ist.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Berechnet mit einer angegebenen Berechnungsmethode den Hash für das aktuelle Tuple<T1,T2,T3,T4>-Objekt.
ITuple.Item[Int32]	Ruft den Wert des angegebenen Elements Tuple ab.
ITuple.Length	Ruft die Anzahl der Elemente im Tuple ab.

Erweiterungsmethoden

Deconstruct<T1,T2,T3,T4>(Tuple<T1,T2,T3,T4>, T1, T2, T3, T4)	Dekonstruiert ein Tupel mit vier Elementen in separate Variablen.
ToValueTuple<T1,T2,T3,T4>(Tuple<T1,T2,T3,T4>)	Konvertiert eine Instanz der Tuple-Klasse in eine Instanz der ValueTuple-Struktur.

Gilt für

Siehe auch

• Tuple
• Tuple<T1>
• Tuple<T1,T2>
• Tuple<T1,T2,T3>
• 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>