Tuple<T1,T2,T3> Klasse

Definition

Stellt ein 3-Tupel (Tripel) 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 Sequenz von Werten. Die Tuple<T1,T2,T3> -Klasse stellt ein 3-Tupel oder Triple dar, bei dem es sich um ein Tupel mit drei Komponenten handelt.

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

Tupel werden häufig auf vier verschiedene Arten verwendet:

  • Zum Darstellen eines einzelnen Sets von Daten. Beispielsweise kann ein Tupel einen Datenbankdatensatz darstellen, und seine Komponenten können einzelne Felder des Datensatzes darstellen.

  • Um einen einfachen Zugriff auf und die Bearbeitung eines DataSets zu ermöglichen. Im folgenden Beispiel wird ein Array von -Objekten definiert, die die Namen der Studenten, ihre durchschnittlichen Testergebnisse und die Tuple<T1,T2,T3> Anzahl der durchgeführten Tests enthalten. Das Array wird an die -Methode übergeben, die den Mittelwert und die ComputeStatistics 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)
    
    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 Parametern out (in C#) oder ByRef Parametern (in Visual Basic) zurück. Im vorherigen Beispiel wird beispielsweise die Zusammenfassende Testergebnissestatistik in einem -Objekt Tuple<T1,T2,T3> zurückgegeben.

  • So übergeben Sie mehrere Werte über einen einzelnen Parameter an eine Methode. Die -Methode verfügt beispielsweise über einen einzelnen Parameter, mit dem Sie einen Wert für die Methode angeben können, die der Thread Thread.Start(Object) beim Start ausgeführt. Wenn Sie ein -Objekt als Methodenargument angeben, können Sie die Startroutine des Threads Tuple<T1,T2,T3> mit drei Datenelementen angeben.

Konstruktoren

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

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

Eigenschaften

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

Equals(Object)

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

GetHashCode()

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

Explizite Schnittstellenimplementierungen

IComparable.CompareTo(Object)

Vergleicht das aktuelle Tuple<T1,T2,T3>-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>-Objekt anhand eines angegebenen Vergleichs mit einem angegebenen Objekt und gibt eine ganze Zahl zurück, die angibt, ob sich das aktuelle Objekt in der Sortierreihenfolge vor dem angegebenen Objekt, 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>-Objekt gleich einem angegebenen Objekt ist.

IStructuralEquatable.GetHashCode(IEqualityComparer)

Berechnet mit einer angegebenen Berechnungsmethode den Hash für das aktuelle Tuple<T1,T2,T3>-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>(Tuple<T1,T2,T3>, T1, T2, T3)

Dekonstruiert ein Tupel mit drei Elementen in separate Variablen.

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

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

Gilt für

Siehe auch