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, T5, T6, T7, TRest>, classe

Représente un objet de n tuples, où n représente 8 ou un chiffre supérieur.

System.Object
  System.Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>

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

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

T5

Type du cinquième composant du tuple.

T6

Type du sixième composant du tuple.

T7

Type du septième composant du tuple.

TRest

Tout objet Tuple générique qui définit les types des composants restants du tuple.

Le type Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> 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, T5, T6, T7, TRest>Initialise une nouvelle instance de la classe Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.
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, T5, T6, T7, TRest> actif.
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, T5, T6, T7, TRest> actif.
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, T5, T6, T7, TRest> actif.
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, T5, T6, T7, TRest> actif.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem5Obtient la valeur du cinquième composant de l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> actif.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem6Obtient la valeur du sixième composant de l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> actif.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreItem7Obtient la valeur du septième composant de l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> actif.
Propriété publiquePris en charge par Bibliothèque de classes portablePris en charge dans .NET pour les applications du Windows StoreRestObtient les composants restants de l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> actif.
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, T5, T6, T7, TRest> actuel 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 StoreGetHashCodeCalcule le code de hachage pour l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> actuel. (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, T5, T6, T7, TRest>. (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, T5, T6, T7, TRest> 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, T5, T6, T7, TRest> 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, T5, T6, T7, TRest> actif 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, T5, T6, T7, TRest> 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, T5, T6, T7, TRest> représente un objet de n-tuple qui a 8 composants ou plus.

Vous pouvez instancier un objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> avec exactement huit composants en appelant la méthode Tuple.Create statique. L'exemple suivant crée un 8-tuple (octuple) qui contient les nombres premiers inférieurs à 20. Notez qu'il utilise l'inférence de type pour déterminer le type de chaque composant.


var primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19);
Console.WriteLine("Prime numbers less than 20: " + 
                  "{0}, {1}, {2}, {3}, {4}, {5}, {6}, and {7}",
                  primes.Item1, primes.Item2, primes.Item3, 
                  primes.Item5, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 11, 11, 13, 17, and 19


Vous pouvez également instancier un objet n-tuple avec huit ou plus de composants en appelant le constructeur Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>. L'exemple suivant utilise le constructeur Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> pour créer un objet à 8 tuples qui est équivalent au tuple créés dans l'exemple précédent.


var primes = new Tuple<Int32, Int32, Int32, Int32, Int32, Int32, Int32,  
             Tuple<Int32>> (2, 3, 5, 7, 11, 13, 17, new Tuple<Int32>(19));


RemarqueRemarque

Pour créer un tuple de n avec neuf composants ou plus, vous devez appeler le constructeur Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>. Les méthodes de fabrique statiques de la classe Tuple ne prennent pas en charge la création d'objets Tuple avec plus de huit composants.

Pour instancier un tuple de n qui a huit composants ou plus avec le constructeur Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>, vous fournissez un objet Tuple générique comme paramètre rest pour définir les composants 8 à n du tuple. En imbriquant des objets Tuple génériques dans cette façon, vous pouvez créer un tuple qui n'a aucune limitation pratique sur le nombre de ses composants.

L'exemple suivant crée un objet de 17 tuples qui contient les données relatives à la population pour la ville de Détroit, Michigan, pour chaque recensement national de 1860 à 2000. Le premier composant du tuple est le nom de la ville. Le deuxième composant est la date de début de la série de données, et le troisième composant est la population à la date de début. Chaque composant suivant fournit le remplissage à intervalles de dix ans L'objet de 17 tuples est créé en imbriquant un objet Tuple<T1, T2, T3> à l'intérieur d'un objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>. (C'est-à-dire, l'objet Tuple<T1, T2, T3> est fournir comme valeur du paramètre rest dans le constructeur de la classe Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.) Cet objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>, ensuite, est imbriqué dans un objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> externe. (C'est-à-dire, l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> est fournir comme valeur du paramètre rest dans le constructeur de la classe de l'objet Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> externe.)


var from1980 = Tuple.Create(1203339, 1027974, 951270);
var from1910 = new Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>> 
    (465766, 993078, 1568622, 1623452, 1849568, 1670144, 1511462, from1980);
var population = new Tuple<string, int, int, int, int, int, int,
    Tuple<int, int, int, int, int, int, int, Tuple<int, int, int>>> 
    ("Detroit", 1860, 45619, 79577, 116340, 205876, 285704, from1910);


Vous pouvez extraire la valeur des sept premiers composants du tuple à l'aide des propriétés d'instance Item1, Item2, Item3, Item4, Item5, Item6et Item7 en lecture seule. Les composants additionnels sont imbriqués et peuvent être extraits de la propriété Rest. Dans l'exemple précédent, les propriétés Item1 à Item7 extraient les composants 1 à 7 du tuple. Les composants 8 à 14 sont contenus dans le tuple imbriqué au deuxième niveau et sont représentés par le Rest.Item1 via des propriétés Rest.Item7. Les composants 15 à 17 sont contenus dans le tuple imbriqué au troisième niveau et sont représentés par le Rest.Rest.Item1 via des propriétés Rest.Rest.Item3.

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.

  • 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 ville, dans un objet Tuple<T1, T2, T3, T4, T5, T6, T7>.

  • 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, T5, T6, T7> comme argument de méthode, vous pouvez fournir la routine de démarrage du thread avec sept é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
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft