Tuple<T1,T2,T3> Klasse

Definition

Stellt ein 3-Tupel oder dreifach dar.

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

Vererbung
Tuple<T1,T2,T3>
Attribute
Implementiert

Hinweise

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

Sie können ein Tuple<T1,T2,T3> Objekt instanziieren, indem Sie entweder den Tuple<T1,T2,T3> Konstruktor oder die statische Tuple.Create<T1,T2,T3>(T1, T2, T3) Methode aufrufen. Sie können die Werte der Tupelkomponenten abrufen, indem Sie die schreibgeschützten Item1Eigenschaften Item2und Item3 Instanzeneigenschaften 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> Objekten definiert, die die Namen der Kursteilnehmer, ihre durchschnittlichen Testergebnisse und die Anzahl der durchgeführten Tests enthalten. Das Array wird an die ComputeStatistics Methode übergeben, die die Mittel- und Standardabweichung der Testergebnisse berechnet.

    using System;
    
    public class Example
    {
       public static void Main()
       {
          Tuple<string, double, int>[] scores = 
                        { Tuple.Create("Jack", 78.8, 8),
                          Tuple.Create("Abbey", 92.1, 9), 
                          Tuple.Create("Dave", 88.3, 9),
                          Tuple.Create("Sam", 91.7, 8), 
                          Tuple.Create("Ed", 71.2, 5),
                          Tuple.Create("Penelope", 82.9, 8),
                          Tuple.Create("Linda", 99.0, 9),
                          Tuple.Create("Judith", 84.3, 9) };
          var result = ComputeStatistics(scores);
          Console.WriteLine("Mean score: {0:N2} (SD={1:N2}) (n={2})", 
                            result.Item2, result.Item3, result.Item1);
       }
    
       private static Tuple<int, double, double> ComputeStatistics(Tuple<string, double, int>[] scores) 
       {
          int n = 0;
          double sum = 0;
    
          // Compute the mean.
          foreach (var score in scores)
          {
             n += score.Item3;
             sum += score.Item2 * score.Item3;
          }
          double mean = sum / n;
          
          // Compute the standard deviation.
          double ss = 0;
          foreach (var score in scores)
          {
             ss = Math.Pow(score.Item2 - mean, 2);
          }
          double sd = Math.Sqrt(ss/scores.Length);
          return Tuple.Create(scores.Length, mean, sd);
       }
    }
    // The example displays the following output:
    //       Mean score: 87.02 (SD=0.96) (n=8)
    
    open System
    
    let computeStatistics (scores: Tuple<string, double, int>[]) = 
        let mutable n = 0
        let mutable sum = 0.
    
        // Compute the mean.
        for score in scores do
            n <- n + score.Item3
            sum <- sum + score.Item2 * double score.Item3
        let mean = sum / double n
        
        // Compute the standard deviation.
        let mutable ss = 0.
        for score in scores do
            ss <- (score.Item2 - mean) ** 2.
        let sd = sqrt (ss / double scores.Length)
        Tuple.Create(scores.Length, mean, sd)
    
    let scores = 
        [| Tuple.Create("Jack", 78.8, 8)
           Tuple.Create("Abbey", 92.1, 9) 
           Tuple.Create("Dave", 88.3, 9)
           Tuple.Create("Sam", 91.7, 8) 
           Tuple.Create("Ed", 71.2, 5)
           Tuple.Create("Penelope", 82.9, 8)
           Tuple.Create("Linda", 99.0, 9)
           Tuple.Create("Judith", 84.3, 9) |]
    let result = computeStatistics scores
    printfn $"Mean score: {result.Item2:N2} (SD={result.Item3:N2}) (n={result.Item1})"
    // The example displays the following output:
    //       Mean score: 87.02 (SD=0.96) (n=8)
    
    Module Example
       Public Sub Main()
          Dim scores() = 
                          { Tuple.Create("Jack", 78.8, 8),
                            Tuple.Create("Abbey", 92.1, 9), 
                            Tuple.Create("Dave", 88.3, 9),
                            Tuple.Create("Sam", 91.7, 8), 
                            Tuple.Create("Ed", 71.2, 5),
                            Tuple.Create("Penelope", 82.9, 8),
                            Tuple.Create("Linda", 99.0, 9),
                            Tuple.Create("Judith", 84.3, 9) }
          Dim result = ComputeStatistics(scores)
          Console.WriteLine("Mean score: {0:N2} (SD={1:N2}) (n={2})", 
                            result.Item2, result.Item3, result.Item1)
       End Sub
       
       Private Function ComputeStatistics(scores() As Tuple(Of String, Double, Integer)) _ 
                                    As Tuple(Of Integer, Double, Double)
          Dim n As Integer = 0      
          Dim sum As Double = 0
          
          ' Compute the mean.
          For Each score In scores
             n+= score.Item3 
             sum += score.Item2 * score.Item3
          Next     
          Dim mean As Double = sum / n
    
          ' Compute the standard deviation.
          Dim ss As Double = 0
          For Each score In scores
             ss = Math.Pow(score.Item2 - mean, 2)
          Next
          Dim sd As Double = Math.Sqrt(ss/scores.Length)
          Return Tuple.Create(scores.Length, mean, sd)
       End Function
    End Module
    ' The example displays the following output:
    '       Mean score: 87.02 (SD=0.96) (n=8)
    
  • 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 Statistiken zur Zusammenfassungstestbewertung in einem Tuple<T1,T2,T3> 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> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit drei Datenelementen bereitstellen.

Konstruktoren

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

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

Eigenschaften

Name Beschreibung
Item1

Ruft den Wert der ersten Komponente des aktuellen Tuple<T1,T2,T3> Objekts ab.

Item2

Ruft den Wert der zweiten Komponente des aktuellen Tuple<T1,T2,T3> Objekts ab.

Item3

Ruft den Wert der dritten Komponente des aktuellen Tuple<T1,T2,T3> Objekts ab.

Methoden

Name Beschreibung
Equals(Object)

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

GetHashCode()

Gibt den Hashcode für das aktuelle Tuple<T1,T2,T3> 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> Instanz darstellt.

Explizite Schnittstellenimplementierungen

Name Beschreibung
IComparable.CompareTo(Object)

Vergleicht das aktuelle Tuple<T1,T2,T3> 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> 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> Objekt einem angegebenen Objekt entspricht, basierend auf einer angegebenen Vergleichsmethode.

IStructuralEquatable.GetHashCode(IEqualityComparer)

Berechnet den Hashcode für das aktuelle Tuple<T1,T2,T3> 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>(Tuple<T1,T2,T3>, T1, T2, T3)

Deconstructs a tupel with 3 elements into separate variables.

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

Konvertiert eine Instanz der Tuple Klasse in eine Instanz der ValueTuple Struktur.

Gilt für:

Weitere Informationen