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

 

Publication: juillet 2016

Fournit des méthodes statiques pour la création d’objets tuple.

Pour parcourir le code source .NET Framework pour ce type, consultez la Reference Source.

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


public static class Tuple

NomDescription
System_CAPS_pubmethodSystem_CAPS_staticCreate<T1>(T1)

Crée un tuple à 1 composant, ou singleton.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2>(T1, T2)

Crée un tuple à 2 composants, ou paire.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3>(T1, T2, T3)

Crée un tuple à 3 composants, ou triple.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3, T4>(T1, T2, T3, T4)

Crée un tuple à 4 composants, ou quadruple.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3, T4, T5>(T1, T2, T3, T4, T5)

Crée un tuple à 5 composants, ou quintuple.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3, T4, T5, T6>(T1, T2, T3, T4, T5, T6)

Crée un tuple à 6 composants, ou sextuple.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3, T4, T5, T6, T7>(T1, T2, T3, T4, T5, T6, T7)

Crée un tuples à 7 composants, ou septuple.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2, T3, T4, T5, T6, T7, T8>(T1, T2, T3, T4, T5, T6, T7, T8)

Crée un tuples à 8 composants, ou octuple.

System_CAPS_noteRemarque

Pour afficher le code source .NET Framework pour ce type, consultez la Reference Source. Vous pouvez parcourir le code source en ligne, télécharger la référence hors connexion et parcourir les sources (y compris les correctifs et mises à jour) pendant le débogage ; see instructions.

Un tuple est une structure de données qui a un nombre spécifique et une séquence d’éléments. Un exemple d’un tuple est une structure de données avec trois éléments (également appelé 3 tuples ou triple) qui est utilisée pour stocker un identificateur comme nom d’une personne dans le premier élément, une année dans le deuxième élément et les revenus de la personne pour cette année dans le troisième élément. Le .NET Framework prend en charge directement les tuples avec un à sept éléments. En outre, vous pouvez créer des tuples de huit ou plusieurs éléments en imbriquant des objets tuple dans le Rest propriété d’un Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> objet.

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

  • 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 de l’enregistrement.

  • Pour fournir un accès facile aux et manipulation d’un jeu de données.

  • Pour retourner plusieurs valeurs à partir d’une méthode sans utiliser out (en c#) ou ByRef Paramètres (Visual Basic).

  • 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 en tant qu’argument de méthode, vous pouvez fournir la routine de démarrage du thread avec trois éléments de données.

La Tuple classe ne représente pas de lui-même un tuple. Au lieu de cela, c’est une classe qui fournit des méthodes statiques pour créer des instances des types de tuple prises en charge par le .NET Framework. Il fournit des méthodes d’assistance que vous pouvez appeler pour instancier des objets tuples sans devoir spécifier explicitement le type de chaque composant du tuple.

Bien que vous pouvez créer une instance d’une classe de tuple en appelant son constructeur de classe, le code peut être fastidieux. L’exemple suivant utilise un constructeur de classe pour créer un objet de 7 tuples, ou septuple qui contient les données de population pour la ville de New York pour chaque recensement entre 1950 et 2000.

// Create a 7-tuple.
var population = new Tuple<string, int, int, int, int, int, int>(
                           "New York", 7891957, 7781984, 
                           7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278

Créer le même objet de tuple à l’aide d’une méthode d’assistance est plus simple, comme le montre l’exemple suivant.

// Create a 7-tuple.
var population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278);
// Display the first and last elements.
Console.WriteLine("Population of {0} in 2000: {1:N0}",
                  population.Item1, population.Item7);
// The example displays the following output:
//       Population of New York in 2000: 8,008,278

Le Create des méthodes d’assistance prennent directement en charge la création d’objets tuple qui ont d’un à huit composants (autrement dit, singletons à octuples). Bien qu’il n’existe aucune limite pratique au nombre de composants, un tuple peut avoir, les méthodes d’assistance ne sont pas disponibles pour créer un tuple avec neuf composants ou plus. Pour créer un tuple de ce type, vous devez appeler le Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> constructeur.

System_CAPS_noteRemarque

Pour plus d’informations et des exemples qui utilisent des tuples, consultez la documentation pour les types individuels d’un tuple dans le .NET Framework. Ils sont indiqués dans la section Voir aussi à la fin de cette rubrique.

L’exemple suivant crée un 8-tuple (octuple) qui contient les nombres premiers inférieurs à 20.

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.Item4, primes.Item5, primes.Item6,
                  primes.Item7, primes.Rest.Item1);
// The example displays the following output:
//    Prime numbers less than 20: 2, 3, 5, 7, 11, 13, 17, and 19

Universal Windows Platform
Disponible depuis 8
.NET Framework
Disponible depuis 4.0
Portable Class Library
Pris en charge dans : portable .NET platforms
Silverlight
Disponible depuis 4.0
Windows Phone Silverlight
Disponible depuis 8.0
Windows Phone
Disponible depuis 8.1

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

Retour au début
Afficher: