Tuple<T1,T2,T3> Osztály

Definíció

Névtér:

System

Szerelvény:

mscorlib.dll

3- vagy tripla értéket jelöl.

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

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

[<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

Típusparaméterek

T1

A rekord első összetevőjének típusa.

T2

A rekord második összetevőjének típusa.

T3

A rekord harmadik összetevőjének típusa.

Öröklődés

Object

Tuple<T1,T2,T3>

Attribútumok

SerializableAttribute

Megvalósítás

IStructuralComparable IStructuralEquatable IComparable ITuple

Megjegyzések

A rekord egy adatszerkezet, amely meghatározott számú és értéksorozatú. Az Tuple<T1,T2,T3> osztály egy 3-10-et vagy triplát jelöl, amely egy három összetevőből álló rekord.

Az objektumok példányosításához Tuple<T1,T2,T3> hívja meg a Tuple<T1,T2,T3> konstruktort vagy a statikus Tuple.Create<T1,T2,T3>(T1, T2, T3) metódust. A rekord összetevőinek értékeit lekérheti az írásvédett Item1, Item2és Item3 a példánytulajdonságok használatával.

A csuplokat általában négy különböző módon használják:

• Egyetlen adatkészlet ábrázolása. Egy rekord például egy adatbázisrekordot, összetevői pedig a rekord egyes mezőit jelölhetik.

• Az adathalmazokhoz való könnyű hozzáférés és kezelés biztosítása. Az alábbi példa egy objektumtömböt Tuple<T1,T2,T3> határoz meg, amely tartalmazza a diákok nevét, az átlagos teszteredményeket és a végrehajtott tesztek számát. A rendszer átadja a tömböt a ComputeStatistics metódusnak, amely kiszámítja a vizsgálati pontszámok középértékét és szórását.

  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)
  

• Több érték visszaadása egy metódusból out paraméterek használata nélkül (C#-ban) vagy ByRef paraméterek használata nélkül (Visual Basic). Az előző példa például egy objektum összesített tesztpontszám-statisztikáját Tuple<T1,T2,T3> adja vissza.

• Több érték átadása egy metódusnak egyetlen paraméteren keresztül. A metódus például egyetlen paraméterrel rendelkezik, Thread.Start(Object) amely lehetővé teszi, hogy egy értéket adjon meg a szál indításkor végrehajtott metódusának. Ha metódusargumentumként egy objektumot Tuple<T1,T2,T3> ad meg, a szál indítási rutinját három adatelemet is megadhat.

Konstruktorok

Name	Description
Tuple<T1,T2,T3>(T1, T2, T3)	Inicializálja a Tuple<T1,T2,T3> osztály új példányát.

Tulajdonságok

Name	Description
Item1	Lekéri az aktuális Tuple<T1,T2,T3> objektum első összetevőjének értékét.
Item2	Lekéri az aktuális Tuple<T1,T2,T3> objektum második összetevőjének értékét.
Item3	Lekéri az aktuális Tuple<T1,T2,T3> objektum harmadik összetevőjének értékét.

Metódusok

Name	Description
Equals(Object)	Olyan értéket ad vissza, amely jelzi, hogy az aktuális Tuple<T1,T2,T3> objektum egyenlő-e egy adott objektummal.
GetHashCode()	Az aktuális Tuple<T1,T2,T3> objektum kivonatkódját adja vissza.
GetType()	Lekéri az Type aktuális példányt. (Öröklődés forrása Object)
MemberwiseClone()	Az aktuális Objectpéldány sekély másolatát hozza létre. (Öröklődés forrása Object)
ToString()	A példány értékét Tuple<T1,T2,T3> képviselő sztringet ad vissza.

Explicit interfész-implementációk

Name	Description
IComparable.CompareTo(Object)	Összehasonlítja az aktuális Tuple<T1,T2,T3> objektumot egy adott objektummal, és egy egész számot ad vissza, amely jelzi, hogy az aktuális objektum a rendezési sorrendben a megadott objektum előtt, után vagy ugyanabban a pozícióban van-e.
IStructuralComparable.CompareTo(Object, IComparer)	Összehasonlítja az aktuális Tuple<T1,T2,T3> objektumot egy megadott objektummal egy megadott összehasonlító használatával, és egy egész számot ad vissza, amely jelzi, hogy az aktuális objektum a rendezési sorrendben a megadott objektum előtt, után vagy ugyanabban a pozícióban van-e.
IStructuralEquatable.Equals(Object, IEqualityComparer)	Olyan értéket ad vissza, amely azt jelzi, hogy az aktuális Tuple<T1,T2,T3> objektum egy adott objektummal egyenlő-e egy megadott összehasonlító módszer alapján.
IStructuralEquatable.GetHashCode(IEqualityComparer)	Kiszámítja az aktuális Tuple<T1,T2,T3> objektum kivonatkódját egy megadott számítási módszerrel.
ITuple.Item[Int32]	Lekéri a megadott Tuple elem értékét.
ITuple.Length	Lekéri a Tuple.

Bővítő metódusok

Name	Description
Deconstruct<T1,T2,T3>(Tuple<T1,T2,T3>, T1, T2, T3)	A 3 elemet tartalmazó rekordokat külön változókra bontja.
ToValueTuple<T1,T2,T3>(Tuple<T1,T2,T3>)	Átalakítja az Tuple osztály egy példányát a ValueTuple struktúra egy példányává.

Lásd még

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