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

 

Date de publication : novembre 2016

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

Pour parcourir le code source de .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 de .NET Framework pour ce type, consultez la Reference Source. Vous pouvez parcourir le code source en ligne, télécharger la référence de consultation 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é objet de 3 tuples ou triple) qui est utilisée pour stocker un identificateur tel qu’un nom de personne dans le premier élément, une année dans le deuxième élément et au revenu de la personne de 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 plus d’éléments par l’imbrication d’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 façons :

  • 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.

  • Pour retourner plusieurs valeurs à partir d’une méthode sans utiliser de 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 s’exécute au moment du 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.

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

Vous pouvez créer une instance d’une classe de tuple en appelant son constructeur de classe, le code peut s’avérer lourd. L’exemple suivant utilise un constructeur de classe pour créer un objet de 7 tuples, ou septuple qui contient les données de la 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 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 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, 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 la 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 répertorié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

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: