Cet article a fait l’objet d’une traduction automatique. Pour afficher l’article en anglais, activez la case d’option Anglais. Vous pouvez également afficher le texte anglais dans une fenêtre contextuelle en faisant glisser le pointeur de la souris sur le texte traduit.
Traduction
Anglais

Tuple<T1, T2, T3> classe

 

Date de publication : novembre 2016

Représente un objet de 3 tuples, ou triple.

Espace de noms:   System
Assembly:  mscorlib (dans mscorlib.dll)

System.Object
  System.Tuple<T1, T2, T3>

[SerializableAttribute]
public class Tuple<T1, T2, T3> : IStructuralEquatable, IStructuralComparable, 
	IComparable

Paramètres de type

T1

Le type de composant du tuple premier.

T2

Le type du composant du tuple.

T3

Le type de composant du tuple tiers.

NomDescription
System_CAPS_pubmethodTuple<T1, T2, T3>(T1, T2, T3)

Initialise une nouvelle instance de la classe Tuple<T1, T2, T3>.

NomDescription
System_CAPS_pubpropertyItem1

Obtient la valeur de la Tuple<T1, T2, T3> premier composant de l’objet.

System_CAPS_pubpropertyItem2

Obtient la valeur de la Tuple<T1, T2, T3> deuxième composant de l’objet.

System_CAPS_pubpropertyItem3

Obtient la valeur de la Tuple<T1, T2, T3> troisième composant de l’objet.

NomDescription
System_CAPS_pubmethodEquals(Object)

Retourne une valeur qui indique si l’actuel Tuple<T1, T2, T3> objet est égal à un objet spécifié.(Remplace Object.Equals(Object).)

System_CAPS_protmethodFinalize()

Autorise un objet à tenter de libérer des ressources et d'exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par l'opération garbage collection. (Hérité de Object.)

System_CAPS_pubmethodGetHashCode()

Retourne le code de hachage pour l'objet Tuple<T1, T2, T3> actuel.(Remplace Object.GetHashCode().)

System_CAPS_pubmethodGetType()

Obtient le Type de l'instance actuelle.(Hérité de Object.)

System_CAPS_protmethodMemberwiseClone()

Crée une copie superficielle du Object actuel.(Hérité de Object.)

System_CAPS_pubmethodToString()

Retourne une chaîne qui représente la valeur de cette Tuple<T1, T2, T3> instance.(Remplace Object.ToString().)

NomDescription
System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralComparable.CompareTo(Object, IComparer)

Compare l’actuel Tuple<T1, T2, T3> objet à un objet spécifié à l’aide d’un comparateur spécifié et retourne un entier qui indique si l’objet actuel est avant, après ou à la même position que l’objet spécifié dans l’ordre de tri.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.Equals(Object, IEqualityComparer)

Retourne une valeur qui indique si l’actuel Tuple<T1, T2, T3> objet est égal à un objet spécifié selon une méthode de comparaison spécifiée.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIStructuralEquatable.GetHashCode(IEqualityComparer)

Calcule le code de hachage pour l’actuel Tuple<T1, T2, T3> à l’aide d’une méthode de calcul spécifiée.

System_CAPS_pubinterfaceSystem_CAPS_privmethodIComparable.CompareTo(Object)

Compare l’actuel Tuple<T1, T2, T3> objet à un objet spécifié et retourne un entier qui indique si l’objet actuel est avant, après ou à la même position que l’objet spécifié dans l’ordre de tri.

Un tuple est une structure de données qui a un nombre spécifique et une séquence de valeurs. La Tuple<T1, T2, T3> classe représente un objet de 3 tuples, ou triple, qui est un tuple qui a trois composants.

Vous pouvez instancier un Tuple<T1, T2, T3> objet en appelant le Tuple<T1, T2, T3> constructeur ou la méthode statique Tuple.Create<T1, T2, T3>(T1, T2, T3) (méthode). Vous pouvez récupérer les valeurs des composants du tuple à l’aide de la lecture seule Item1, Item2, et Item3 propriétés d’une instance.

Tuples sont utilisés communément de quatre manières différentes :

  • Pour représenter un seul jeu de données. Par exemple, un tuple peut représenter un enregistrement de base de données et ses composants peuvent représenter des champs individuels de l’enregistrement.

  • Pour fournir un accès facile aux et la manipulation d’un jeu de données. L’exemple suivant définit un tableau de Tuple<T1, T2, T3> objets qui contiennent les noms des étudiants, leurs scores moyenne du test et le nombre de tests effectuée. Le tableau est passé à la ComputeStatistics méthode, qui calcule la moyenne et l’écart type des résultats du test.

    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)
    
  • Pour retourner plusieurs valeurs à partir d’une méthode sans utiliser de out (en c#) ou ByRef paramètres (Visual Basic). Par exemple, l’exemple précédent retourne ses statistiques de score de résumé de test dans un Tuple<T1, T2, T3> objet.

  • Pour passer plusieurs valeurs à une méthode via un paramètre unique. Par exemple, le Thread.Start(Object) méthode possède un paramètre unique qui vous permet de fournir une valeur à la méthode que le thread exécute au démarrage. Si vous fournissez un Tuple<T1, T2, T3> de l’objet comme argument de méthode, vous pouvez fournir la routine de démarrage du thread avec trois éléments de données.

Plateforme Windows universelle
Disponible depuis 8
.NET Framework
Disponible depuis 4.0
Bibliothèque de classes portable
Pris en charge dans : plateformes .NET portables
Silverlight
Disponible depuis 4.0
Silverlight pour Windows Phone
Disponible depuis 8.0
Windows Phone
Disponible depuis 8.1

Tous les membres statiques publics ( Shared en Visual Basic) de ce type sont thread-safe. Les membres d’instance n’ont pas la garantie d’être thread-safe.

Retour au début
Afficher: