Exporter (0) Imprimer
Développer tout
Cet article a fait l'objet d'une traduction automatique. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte. Informations supplémentaires.
Traduction
Source

Tuple<T1, T2, T3>, classe

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

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

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

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

Paramètres de type

T1

Type du premier composant du tuple.

T2

Type du second composant du tuple.

T3

Type du troisième composant du tuple.

Le type Tuple<T1, T2, T3> expose les membres suivants.

  NomDescription
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreTuple<T1, T2, T3>Initialise une nouvelle instance de la classe Tuple<T1, T2, T3>.
Début

  NomDescription
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem1Obtient la valeur du premier composant de l'objet Tuple<T1, T2, T3> actuel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem2Obtient la valeur du deuxième composant de l'objet Tuple<T1, T2, T3> actuel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem3Obtient la valeur du troisième composant de l'objet Tuple<T1, T2, T3> actuel.
Début

  NomDescription
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreEqualsRetourne une valeur qui indique si l'objet Tuple<T1, T2, T3> actif est égal à un objet spécifié. (Substitue Object.Equals(Object).)
Méthode protégéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreFinalize 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.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetHashCodeRetourne le code de hachage pour l'objet Tuple<T1, T2, T3> en cours. (Substitue Object.GetHashCode().)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreGetTypeObtient le Type de l'instance actuelle. (Hérité de Object.)
Méthode protégéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreMemberwiseCloneCrée une copie superficielle de l'objet Object actuel. (Hérité de Object.)
Méthode publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreToStringRetourne une chaîne qui représente la valeur de cette instance Tuple<T1, T2, T3>. (Substitue Object.ToString().)
Début

  NomDescription
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIComparable.CompareToCompare l'objet Tuple<T1, T2, T3> actif à un objet spécifié et retourne un entier qui indique si l'objet actif précède, suit ou est dans la même position que l'objet spécifié dans l'ordre de tri.
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIStructuralComparable.CompareToCompare l'objet Tuple<T1, T2, T3> actif à un objet spécifié à l'aide d'un comparateur spécifié et retourne un entier qui indique si l'objet actif précède, suit ou est dans la même position que l'objet spécifié dans l'ordre de tri.
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIStructuralEquatable.EqualsRetourne une valeur qui indique si l'objet Tuple<T1, T2, T3> actuel est égal à un objet spécifié selon une méthode de comparaison spécifiée.
Implémentation d'interface expliciteMéthode privéePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreIStructuralEquatable.GetHashCodeCalcule le code de hachage pour l'objet Tuple<T1, T2, T3> actif à l'aide d'une méthode de calcul spécifiée.
Début

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

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

Les tuples sont utilisés communément de quatre façons différentes :

  • Pour représenter un jeu unique 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 l'accès aisé à un groupe de données et sa manipulation. L'exemple suivant définit un tableau d'objets Tuple<T1, T2, T3> qui contient les noms d'étudiants, leur moyenne de notes d'examens et le nombre d'examens passés. Le tableau est passé à la méthode ComputeStatistics, qui calcule la moyenne et l'écart type des notes d'examen.

    
    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 d'une méthode sans l'utilisation de paramètres de out (en C#) ou paramètres ByRef (en Visual Basic). Par exemple, l'exemple précédent retourne son récapitulatif des statistiques sur les notes obtenues aux tests dans un objet Tuple<T1, T2, T3>.

  • Pour passer plusieurs valeurs à une méthode via un paramètre unique. Par exemple, la méthode Thread.Start(Object) a 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 objet Tuple<T1, T2, T3> comme argument de méthode, vous pouvez fournir la routine de démarrage du thread avec trois éléments de données.

.NET Framework

Pris en charge dans : 4.5.2, 4.5.1, 4.5, 4

.NET Framework Client Profile

Pris en charge dans : 4

Bibliothèque de classes portable

Pris en charge dans : Bibliothèque de classes portable

.NET pour les applications du Windows Store

Pris en charge dans : Windows 8

.NET pour les applications Windows Phone

Pris en charge dans : Windows Phone 8, Silverlight 8.1

Windows Phone 8.1, Windows Phone 8, Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Ajouts de la communauté

AJOUTER
Afficher:
© 2015 Microsoft