Tuple<T1,T2> Klasse

Definition

Namespace:

System

Assembly:

System.Runtime.dll

Assembly:

mscorlib.dll

Assembly:

netstandard.dll

Stellt ein 2-Tupel (Paar) dar.

C#

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

C#

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

C#

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

Typparameter

T1

Der Typ der ersten Komponente des Tupels.

T2

Der Typ der zweiten Komponente des Tupels.

Vererbung

Object

Tuple<T1,T2>

Attribute

SerializableAttribute

Implementiert

IStructuralComparable IStructuralEquatable IComparable ITuple

Hinweise

Ein Tuple ist eine Datenstruktur, die eine bestimmte Anzahl und Sequenz von Werten aufweist. Die Tuple<T1,T2> Klasse stellt ein 2-Tuple oder Paar dar, das ein Tuple ist, das zwei Komponenten enthält. Ein 2-Tuple ähnelt einer KeyValuePair<TKey,TValue> Struktur.

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

Tuples werden häufig auf vier verschiedene Arten verwendet:

• So stellen Sie eine einzelne Gruppe von Daten dar. Beispielsweise kann ein Tuple einen Datensatz in einer Datenbank darstellen, und seine Komponenten können die Felder dieses Datensatzes darstellen.

• Um einen einfachen Zugriff auf und die Manipulation eines Datensatzes zu ermöglichen. Im folgenden Beispiel wird ein Array von Objekten definiert, die die Namen von Tuple<T1,T2> Kursteilnehmern und deren entsprechenden Testbewertungen enthalten. Anschließend wird das Array zum Berechnen der Mitteltestbewertung verwendet.

  C#

  using System;
  
  public class Example
  {
     public static void Main()
     {
        Tuple<string, Nullable<int>>[] scores = 
                      { new Tuple<string, Nullable<int>>("Jack", 78),
                        new Tuple<string, Nullable<int>>("Abbey", 92), 
                        new Tuple<string, Nullable<int>>("Dave", 88),
                        new Tuple<string, Nullable<int>>("Sam", 91), 
                        new Tuple<string, Nullable<int>>("Ed", null),
                        new Tuple<string, Nullable<int>>("Penelope", 82),
                        new Tuple<string, Nullable<int>>("Linda", 99),
                        new Tuple<string, Nullable<int>>("Judith", 84) };
        int number;
        double mean = ComputeMean(scores, out number);
        Console.WriteLine("Average test score: {0:N2} (n={1})", mean, number);
     }
  
     private static double ComputeMean(Tuple<string, Nullable<int>>[] scores, out int n) 
     {
        n = 0;      
        int sum = 0;
        foreach (var score in scores)
        {
           if (score.Item2.HasValue)
           { 
              n += 1;
              sum += score.Item2.Value;
           }
        }     
        if (n > 0)
           return sum / (double) n;
        else
           return 0;
     }
  }
  // The example displays the following output:
  //       Average test score: 87.71 (n=7)
  

• Um mehrere Werte aus einer Methode ohne Verwendung von out Parametern (in C#) oder ByRef Parametern (in Visual Basic) zurückzugeben. Im folgenden Beispiel wird beispielsweise ein Tuple<T1,T2> Objekt verwendet, um den Quotienten und den Rest zurückzugeben, der aus ganzzahliger Teilung resultiert.

  C#

  using System;
  
  public class Class1
  {
     public static void Main()
     {
        int dividend, divisor;
        Tuple<int, int> result;
        
        dividend = 136945; divisor = 178;
        result = IntegerDivide(dividend, divisor);
        if (result != null)
           Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2);
        else
           Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor);
                          
        dividend = Int32.MaxValue; divisor = -2073;
        result = IntegerDivide(dividend, divisor);
        if (result != null)
           Console.WriteLine(@"{0} \ {1} = {2}, remainder {3}", 
                             dividend, divisor, result.Item1, result.Item2);
        else
           Console.WriteLine(@"{0} \ {1} = <Error>", dividend, divisor);
     }
  
     private static Tuple<int, int> IntegerDivide(int dividend, int divisor)
     {
        try {
           int remainder;
           int quotient = Math.DivRem(dividend, divisor, out remainder);
           return new Tuple<int, int>(quotient, remainder);
        }   
        catch (DivideByZeroException) {
           return null;
        }      
     }
  }
  // The example displays the following output:
  //       136945 \ 178 = 769, remainder 63
  //       2147483647 \ -2073 = -1035930, remainder 757
  

• 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> Objekt als Methodenargument angeben, können Sie die Startroutine des Threads mit zwei Datenelementen angeben.

Konstruktoren

Tuple<T1,T2>(T1, T2)

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

Eigenschaften

Item1	Ruft den Wert der ersten Komponente des aktuellen Tuple<T1,T2>-Objekts ab.
Item2	Ruft den Wert der zweiten Komponente des aktuellen Tuple<T1,T2>-Objekts ab.

Methoden

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

Explizite Schnittstellenimplementierungen

IComparable.CompareTo(Object)	Vergleicht das aktuelle Tuple<T1,T2>-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>-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>-Objekt gleich einem angegebenen Objekt ist.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Berechnet mit einer angegebenen Berechnungsmethode den Hash für das aktuelle Tuple<T1,T2>-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>(Tuple<T1,T2>, T1, T2)	Dekonstruiert ein Tupel mit zwei Elementen in separate Variablen.
ToValueTuple<T1,T2>(Tuple<T1,T2>)	Konvertiert eine Instanz der Tuple-Klasse in eine Instanz der ValueTuple-Struktur.

Gilt für

Siehe auch

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