Tuple<T1,T2,T3,T4> Klasse

Definition

Stellt ein 4-Tupel oder ein Vierfach dar.

generic <typename T1, typename T2, typename T3, typename T4>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable
generic <typename T1, typename T2, typename T3, typename T4>
public ref class Tuple : IComparable, System::Collections::IStructuralComparable, System::Collections::IStructuralEquatable, System::Runtime::CompilerServices::ITuple
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable, System.Runtime.CompilerServices.ITuple
[System.Serializable]
public class Tuple<T1,T2,T3,T4> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralComparable
    interface IStructuralEquatable
    interface IComparable
    interface ITuple
[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
    interface ITuple
Public Class Tuple(Of T1, T2, T3, T4)
Implements IComparable, IStructuralComparable, IStructuralEquatable
Public Class Tuple(Of T1, T2, T3, T4)
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.

Vererbung
Tuple<T1,T2,T3,T4>
Attribute
Implementiert

Hinweise

Ein Tupel ist eine Datenstruktur mit einer bestimmten Anzahl und Abfolge von Werten. Die Tuple<T1,T2,T3,T4> Klasse stellt ein 4-Tupel oder vierfaches Tupel dar, bei dem es sich um ein Tupel mit vier Komponenten handelt.

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 Tupelkomponenten abrufen, indem Sie die schreibgeschützten Item1, , Item2, und Item3Item4 Instanzeigenschaften verwenden.

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. Im folgenden Beispiel wird ein Array von Tuple<T1,T2,T3,T4> Objekten definiert, die die Namen von Baseball-Pitchern, die Anzahl der Innings, die sie pitchten, 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 der Pro-Inning-Treffer. Die Methode verwendet auch diese beiden Mittelwerte, um einen hypothetischen Effektivitätsdurchschnitt zu berechnen.

    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
    
    open System
    
    let computeStatistics (pitchers: Tuple<string, decimal, int, int>[]) =
        [| for pitcher in pitchers do
            // Decimal portion of innings pitched represents 1/3 of an inning
            let innings =  truncate (double pitcher.Item2) |> double
            let innings = innings + (double pitcher.Item2 - innings) * 0.33
            
            let ERA = double pitcher.Item4 / innings * 9.
            let hitsPerInning = double pitcher.Item3 / innings
            let EI = (ERA * 2. + hitsPerInning * 9.) / 3.
            Tuple<string, double, double, double>(pitcher.Item1, ERA, hitsPerInning, EI)|]
    
    let 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) |]
    
    let results = computeStatistics pitchers
    
    // Display the results.
    printfn "%-20s %9s %11s %15s\n" "Pitcher" "ERA" "Hits/Inn." "Effectiveness"
    for result in results do
        printfn $"{result.Item1,-20} {result.Item2,9:F2} {result.Item3,11:F2} {result.Item4,15:F2}"
    
    // 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
    
    Imports System.Collections.Generic
    
    Module Example
       Public Sub Main()
          Dim pitchers() =  
                   { Tuple.Create("McHale, Joe", 240.1d, 221, 96),
                     Tuple.Create("Paul, Dave", 233.1d, 231, 84), 
                     Tuple.Create("Williams, Mike", 193.2d, 183, 86),
                     Tuple.Create("Blair, Jack", 168.1d, 146, 65), 
                     Tuple.Create("Henry, Walt", 140.1d, 96, 30),
                     Tuple.Create("Lee, Adam", 137.2d, 109, 45),
                     Tuple.Create("Rohr, Don", 101.0d, 110, 42) }
          Dim results() = ComputeStatistics(pitchers)
    
          ' Display the results.
          Console.WriteLine("{0,-20} {1,9} {2,11} {3,15}", "Pitcher", "ERA", "Hits/Inn.", "Effectiveness")
          Console.WriteLine()
          For Each result In results
             Console.WriteLine("{0,-20} {1,9:F2} {2,11:F2} {3,15:F2}",  
                            result.Item1, result.Item2, result.Item3, result.Item4)
          Next
       End Sub
       
       Private Function ComputeStatistics(pitchers() As Tuple(Of String, Decimal, Integer, Integer)) _ 
                                    As Tuple(Of String, Double, Double, Double)()
          Dim list As New List(Of Tuple(Of String, Double, Double, Double))
          Dim result As Tuple(Of String, Double, Double, Double)
    
          For Each pitcher As Tuple(Of String, Decimal, Integer, Integer) In pitchers
             ' Decimal portion of innings pitched represents 1/3 of an inning
             Dim innings As Double = CDbl(Math.Truncate(pitcher.Item2))
             innings = innings + ((pitcher.Item2 - innings) * .33)
             
             Dim ERA As Double = pitcher.Item4/innings * 9
             Dim hitsPerInning As Double = pitcher.Item3/innings
             Dim EI As Double = (ERA * 2 + hitsPerInning * 9)/3
             result = New Tuple(Of String, Double, Double, Double) _
                               (pitcher.Item1, ERA, hitsPerInning, EI)
             list.Add(result) 
          Next
          Return list.ToArray()
       End Function
    End Module
    ' 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
    
  • So geben Sie mehrere Werte aus einer Methode ohne Verwendung von out Parametern (in C#) oder ByRef Parametern (in Visual Basic) zurück. Beispielsweise gibt das vorherige Beispiel 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 ü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> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit vier Datenelementen bereitstellen.

Konstruktoren

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

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

Eigenschaften

Name Beschreibung
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

Name Beschreibung
Equals(Object)

Gibt einen Wert zurück, der angibt, ob das aktuelle Tuple<T1,T2,T3,T4> Objekt einem angegebenen Objekt entspricht.

GetHashCode()

Gibt den Hashcode für das aktuelle Tuple<T1,T2,T3,T4> Objekt zurück.

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> Instanz darstellt.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IComparable.CompareTo(Object)

Vergleicht das aktuelle Tuple<T1,T2,T3,T4> 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> 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> 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> 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.

Erweiterungsmethoden

Name Beschreibung
Deconstruct<T1,T2,T3,T4>(Tuple<T1,T2,T3,T4>, T1, T2, T3, T4)

Deconstructs a tupel with 4 elements into separate variables.

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:

Weitere Informationen