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, T4>, classe

Représente un objet de 4 tuples, ou quadruple.

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

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

[SerializableAttribute]
public class Tuple<T1, T2, T3, T4> : 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.

T4

Type du quatrième composant du tuple.

Le type Tuple<T1, T2, T3, T4> 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, T4>Initialise une nouvelle instance de la classe Tuple<T1, T2, T3, T4>.
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, T4> 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, T4> 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, T4> actuel.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem4Obtient la valeur du quatrième composant de l'objet Tuple<T1, T2, T3, T4> 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, T4> 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, T4> 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, T4>. (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, T4> actuel à un objet spécifié et retourne un entier qui indique si l'objet actuel 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, T4> 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 se trouve à 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, T4> 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, T4> 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, T4> représente un 4 tuples ou quadruple, qui est un tuple qui a quatre composants.

Vous pouvez instancier un objet Tuple<T1, T2, T3, T4> en appelant le constructeur Tuple<T1, T2, T3, T4> ou la méthode Tuple.Create<T1, T2, T3, T4>(T1, T2, T3, T4) statique. Vous pouvez extraire la valeur des composants du tuple à l'aide des propriétés d'instance Item1, Item2, Item3 et Item4 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, T4> qui contiennent les noms de cruches de base-ball, le nombre de tournées qu'ils ont monté, et le nombre de passages gagnés (passages qui ont marqué des points sans présenter des erreurs), et des touches qu'ils ont laissées. Le tableau est passé à la méthode ComputeStatistics, qui calcule la moyenne de passage gagné (le nombre moyen de passages donnés dans un jeu de neuf tournées) de chaque cruche et le nombre moyen de touches laissées par tournée. La méthode utilise également ces deux moyennes pour calculer une moyenne d'efficacité hypothétique.

    
    using System;
    using System.Collections.Generic;
    
    public class Example
    {
       public static void Main()
       {
          Tuple<string, decimal, int, int>[] pitchers  =  
               { Tuple.Create("McHale, Joe", 240.1m, 221, 96),
                 Tuple.Create("Paul, Dave", 233.1m, 231, 84), 
                 Tuple.Create("Williams, Mike", 193.2m, 183, 86),
                 Tuple.Create("Blair, Jack", 168.1m, 146, 65), 
                 Tuple.Create("Henry, Walt", 140.1m, 96, 30),
                 Tuple.Create("Lee, Adam", 137.2m, 109, 45),
                 Tuple.Create("Rohr, Don", 101.0m, 110, 42) };
          Tuple<string, double, double, double>[] results= ComputeStatistics(pitchers);
    
          // Display the results.
          Console.WriteLine("{0,-20} {1,9} {2,11} {3,15}\n", 
                            "Pitcher", "ERA", "Hits/Inn.", "Effectiveness");
          foreach (var result in results)
             Console.WriteLine("{0,-20} {1,9:F2} {2,11:F2} {3,15:F2}",  
                            result.Item1, result.Item2, result.Item3, result.Item4);
       }
    
       private static Tuple<string, double, double, double>[] ComputeStatistics(Tuple<string, decimal, int, int>[] pitchers)
       {    
          var list = new List<Tuple<string, double, double, double>>();
          Tuple<string, double, double, double> result;
    
          foreach (var pitcher in pitchers)
          {
             // Decimal portion of innings pitched represents 1/3 of an inning
             double innings = (double) Math.Truncate(pitcher.Item2);
             innings = innings + (((double)pitcher.Item2 - innings) * .33);
    
             double ERA = pitcher.Item4/innings * 9;
             double hitsPerInning = pitcher.Item3/innings;
             double EI = (ERA * 2 + hitsPerInning * 9)/3;
             result = new Tuple<string, double, double, double>
                               (pitcher.Item1, ERA, hitsPerInning, EI);
             list.Add(result);
          }
          return list.ToArray();
       }
    }
    // The example displays the following output;
    //       Pitcher                    ERA   Hits/Inn.   Effectiveness
    //       
    //       McHale, Joe               3.60        0.92            5.16
    //       Paul, Dave                3.24        0.99            5.14
    //       Williams, Mike            4.01        0.95            5.52
    //       Blair, Jack               3.48        0.87            4.93
    //       Henry, Walt               1.93        0.69            3.34
    //       Lee, Adam                 2.95        0.80            4.36
    //       Rohr, Don                 3.74        1.09            5.76
    
    
    
  • 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 ses statistiques calculées, avec le nom de la cruche, dans un tableau d'objets Tuple<T1, T2, T3, T4>.

  • 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, T4> comme argument de méthode, vous pouvez fournir la routine de démarrage du thread avec quatre é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:
© 2014 Microsoft