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

Referenz

Definition

Namespace:: System

Assembly:: System.Runtime.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Stellt ein 7-Tupel (Septupel) dar.

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

generic <typename T1, typename T2, typename T3, typename T4, typename T5, typename T6, typename T7>
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> : IComparable, System.Collections.IStructuralComparable, System.Collections.IStructuralEquatable

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

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

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

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

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6, 'T7> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable

[<System.Serializable>]
type Tuple<'T1, 'T2, 'T3, 'T4, 'T5, 'T6, 'T7> = class
    interface IStructuralEquatable
    interface IStructuralComparable
    interface IComparable
    interface ITuple

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

Public Class Tuple(Of T1, T2, T3, T4, T5, T6, T7)
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.

Vererbung: Object
Tuple<T1,T2,T3,T4,T5,T6,T7>

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,T5,T6,T7> Klasse stellt ein 7-Tupel oder ein Septuple dar, das ein Tupel mit sieben Komponenten ist.

Sie können ein Tuple<T1,T2,T3,T4,T5,T6,T7> Objekt instanziieren, indem Sie entweder die statische Methode oder die Tuple<T1,T2,T3,T4,T5,T6,T7> statische Tuple.Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7) Methode aufrufen. Sie können den Wert der Komponenten des Tupels mithilfe der schreibgeschützten Item1, Item2, , Item3, Item4 Item5, Item6und Item7 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 Tuple<T1,T2,T3,T4,T5,T6,T7> Objekt definiert, das Bevölkerungsdaten für new York City für jede Zählung von 1950 bis 2000 enthält. Die Septuple wird an die ComputePopulationChange Methode übergeben, die die jährliche Änderungsrate zwischen Zählungen sowie die jährliche Änderungsrate für den gesamten 60-Jahreszeitraum berechnet.

using System;

public class Example
{
   public static void Main()
   {
      // Get population data for New York City, 1950-2000.
      var population = Tuple.Create("New York", 7891957, 7781984, 
                                    7894862, 7071639, 7322564, 8008278);
      var rate = ComputePopulationChange(population);
      // Display results.
      Console.WriteLine("Population Change, {0}, 1950-2000\n", population.Item1);
      Console.WriteLine("Year      {0,10} {1,9}", "Population", "Annual Rate");
      Console.WriteLine("1950      {0,10:N0} {1,11}", population.Item2, "NA");
      Console.WriteLine("1960      {0,10:N0} {1,11:P2}", population.Item3, rate.Item2/10);
      Console.WriteLine("1970      {0,10:N0} {1,11:P2}", population.Item4, rate.Item3/10);
      Console.WriteLine("1980      {0,10:N0} {1,11:P2}", population.Item5, rate.Item4/10);
      Console.WriteLine("1990      {0,10:N0} {1,11:P2}", population.Item6, rate.Item5/10);
      Console.WriteLine("2000      {0,10:N0} {1,11:P2}", population.Item7, rate.Item6/10);
      Console.WriteLine("1950-2000 {0,10:N0} {1,11:P2}", "", rate.Item7/50);
   }

   private static Tuple<string, double, double, double, double, double, double> 
        ComputePopulationChange(
           Tuple<string, int, int, int, int, int, int> data)  
   {           
      var rate = Tuple.Create(data.Item1, 
                       (double)(data.Item3 - data.Item2)/data.Item2, 
                       (double)(data.Item4 - data.Item3)/data.Item3, 
                       (double)(data.Item5 - data.Item4)/data.Item4, 
                       (double)(data.Item6 - data.Item5)/data.Item5,
                       (double)(data.Item7 - data.Item6)/data.Item6,
                       (double)(data.Item7 - data.Item2)/data.Item2 );
      return rate;
   }           
}
// The example displays the following output:
//       Population Change, New York, 1950-2000
//       
//       Year      Population Annual Rate
//       1950       7,891,957          NA
//       1960       7,781,984     -0.14 %
//       1970       7,894,862      0.15 %
//       1980       7,071,639     -1.04 %
//       1990       7,322,564      0.35 %
//       2000       8,008,278      0.94 %
//       1950-2000                 0.03 %

open System

let computePopulationChange (data: Tuple<string, int, int, int, int, int, int>) =  
    Tuple.Create(data.Item1, 
                 double (data.Item3 - data.Item2) / double data.Item2, 
                 double (data.Item4 - data.Item3) / double data.Item3, 
                 double (data.Item5 - data.Item4) / double data.Item4, 
                 double (data.Item6 - data.Item5) / double data.Item5,
                 double (data.Item7 - data.Item6) / double data.Item6,
                 double (data.Item7 - data.Item2) / double data.Item2)

// Get population data for New York City, 1950-2000.
let population = 
    Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
let rate = computePopulationChange population
// Display results.
printfn $"Population Change, {population.Item1}, 1950-2000\n"
printfn $"""Year      {"Population",10} {"Annual Rate",9}"""
printfn $"""1950      {population.Item2,10:N0} {"NA",11}"""
printfn $"1960      {population.Item3,10:N0} {rate.Item2 / 10.,11:P2}"
printfn $"1970      {population.Item4,10:N0} {rate.Item3 / 10.,11:P2}" 
printfn $"1980      {population.Item5,10:N0} {rate.Item4 / 10.,11:P2}" 
printfn $"1990      {population.Item6,10:N0} {rate.Item5 / 10.,11:P2}" 
printfn $"2000      {population.Item7,10:N0} {rate.Item6 / 10.,11:P2}" 
printfn $"""1950-2000 {"",10:N0} {rate.Item7 / 50.,11:P2}"""

// The example displays the following output:
//       Population Change, New York, 1950-2000
//       
//       Year      Population Annual Rate
//       1950       7,891,957          NA
//       1960       7,781,984     -0.14 %
//       1970       7,894,862      0.15 %
//       1980       7,071,639     -1.04 %
//       1990       7,322,564      0.35 %
//       2000       8,008,278      0.94 %
//       1950-2000                 0.03 %

Module Example
   Public Sub Main()
      ' Get population data for New York City, 1950-2000.
      Dim population = Tuple.Create("New York", 7891957, 7781984, 
                                    7894862, 7071639, 7322564, 8008278)
      Dim rate = ComputePopulationChange(population)      
      ' Display results.
      Console.WriteLine("Population Change, {0}, 1950-2000", population.Item1)
      Console.WriteLine()
      Console.WriteLine("Year      {0,10} {1,9}", "Population", "Annual Rate")
      Console.WriteLine("1950      {0,10:N0} {1,11}", population.Item2, "NA")
      Console.WriteLine("1960      {0,10:N0} {1,11:P2}", population.Item3, rate.Item2/10)
      Console.WriteLine("1970      {0,10:N0} {1,11:P2}", population.Item4, rate.Item3/10)
      Console.WriteLine("1980      {0,10:N0} {1,11:P2}", population.Item5, rate.Item4/10)
      Console.WriteLine("1990      {0,10:N0} {1,11:P2}", population.Item6, rate.Item5/10)
      Console.WriteLine("2000      {0,10:N0} {1,11:P2}", population.Item7, rate.Item6/10)
      Console.WriteLine("1950-2000 {0,10:N0} {1,11:P2}", "", rate.Item7/50)
   End Sub
   
      ' Compute rate of population change by decade and overall.
   Private Function ComputePopulationChange(data As Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer)) _ 
           As Tuple(Of String, Double, Double, Double, Double, Double, Double)
      Dim rate = Tuple.Create( data.Item1, 
                       (data.Item3 - data.Item2)/data.Item2, 
                       (data.Item4 - data.Item3)/data.Item3, 
                       (data.Item5 - data.Item4)/data.Item4, 
                       (data.Item6 - data.Item5)/data.Item5,
                       (data.Item7 - data.Item6)/data.Item6,
                       (data.Item7 - data.Item2)/data.Item2 )
      Return rate
   End Function           
End Module
' The example displays the following output:
'       Population Change, New York, 1950-2000
'       
'       Year      Population Annual Rate
'       1950       7,891,957          NA
'       1960       7,781,984     -0.14 %
'       1970       7,894,862      0.15 %
'       1980       7,071,639     -1.04 %
'       1990       7,322,564      0.35 %
'       2000       8,008,278      0.94 %
'       1950-2000                 0.03 %

Um mehrere Werte aus einer Methode zurückzugeben, ohne parameter (in C#) oder ByRef Parametern (in Visual Basic) zu verwendenout. Beispielsweise gibt das vorherige Beispiel seine berechneten Statistiken zusammen mit dem Stadtnamen in einem Tuple<T1,T2,T3,T4,T5,T6,T7> Objekt 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,T5,T6,T7> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit sieben Datenelementen bereitstellen.

Konstruktoren

Tuple<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

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

Eigenschaften

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

Methoden

Equals(Object)	Gibt einen Wert zurück, der angibt, ob das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7>-Objekt gleich einem angegebenen Objekt ist.
GetHashCode()	Gibt den Hashcode für das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7>-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,T5,T6,T7>-Instanz darstellt.

Explizite Schnittstellenimplementierungen

IComparable.CompareTo(Object)	Vergleicht das aktuelle Tuple<T1,T2,T3,T4,T5,T6,T7>-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,T5,T6,T7>-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,T4,T5,T6,T7>-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,T5,T6,T7>-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,T5,T6,T7>(Tuple<T1,T2,T3,T4,T5,T6,T7>, T1, T2, T3, T4, T5, T6, T7)	Dekonstruiert ein Tupel mit sieben Elementen in separate Variablen.
ToValueTuple<T1,T2,T3,T4,T5,T6,T7>(Tuple<T1,T2,T3,T4,T5,T6,T7>)	Konvertiert eine Instanz der `Tuple`-Klasse in eine Instanz der `ValueTuple`-Struktur.

Gilt für