Tuple Tuple Tuple Tuple Class

Définition

Fournit des méthodes statiques pour la création d'objets de tuple.Provides static methods for creating tuple objects.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Héritage
TupleTupleTupleTuple

Exemples

L’exemple suivant crée un octuple de 8 tuples qui contient des nombres premiers inférieurs à 20.The following example creates an 8-tuple (octuple) that contains prime numbers that are less than 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
Dim 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

Remarques

Un tuple est une structure de données qui a un nombre et une séquence d’éléments spécifiques.A tuple is a data structure that has a specific number and sequence of elements. Un exemple de tuple est une structure de données avec trois éléments (appelé 3 tuples ou triple) qui est utilisé pour stocker un identificateur tel que le nom d’une personne dans le premier élément, une année dans le deuxième élément et le revenu de la personne pour cette année dans le troisième élément.An example of a tuple is a data structure with three elements (known as a 3-tuple or triple) that is used to store an identifier such as a person's name in the first element, a year in the second element, and the person's income for that year in the third element. Le .NET Framework prend directement en charge les tuples avec un à sept éléments.The .NET Framework directly supports tuples with one to seven elements. En outre, vous pouvez créer des tuples de huit éléments ou plus en imbriquant les objets tuples dans Rest la Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> propriété d’un objet.In addition, you can create tuples of eight or more elements by nesting tuple objects in the Rest property of a Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> object.

Les tuples sont couramment utilisés de quatre façons:Tuples are commonly used in four ways:

  • Pour représenter un jeu de données unique.To represent a single set of data. 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.For example, a tuple can represent a database record, and its components can represent individual fields of the record.

  • Pour faciliter l’accès et la manipulation d’un jeu de données.To provide easy access to, and manipulation of, a data set.

  • Pour retourner plusieurs valeurs à partir d’une méthode out sans utiliser de C#paramètres ( ByRef en) ou de paramètres (dans Visual Basic).To return multiple values from a method without using out parameters (in C#) or ByRef parameters (in Visual Basic).

  • Pour passer plusieurs valeurs à une méthode via un paramètre unique.To pass multiple values to a method through a single parameter. Par exemple, la Thread.Start(Object) méthode a un seul paramètre qui vous permet de fournir une valeur à la méthode exécutée par le thread au moment du démarrage.For example, the Thread.Start(Object) method has a single parameter that lets you supply one value to the method that the thread executes at startup time. Si vous fournissez Tuple<T1,T2,T3> un objet comme argument de la méthode, vous pouvez fournir la routine de démarrage du thread avec trois éléments de données.If you supply a Tuple<T1,T2,T3> object as the method argument, you can supply the thread's startup routine with three items of data.

La Tuple classe ne représente pas elle-même un tuple.The Tuple class does not itself represent a tuple. Au lieu de cela, il s’agit d’une classe qui fournit des méthodes statiques pour créer des instances des types de tuples pris en charge par l' .NET Framework.Instead, it is a class that provides static methods for creating instances of the tuple types that are supported by the .NET Framework. Il fournit des méthodes d’assistance que vous pouvez appeler pour instancier des objets Tuple sans avoir à spécifier explicitement le type de chaque composant Tuple.It provides helper methods that you can call to instantiate tuple objects without having to explicitly specify the type of each tuple component.

Bien que vous puissiez créer une instance d’une classe Tuple en appelant son constructeur de classe, le code à cette fin peut être fastidieux.Although you can create an instance of a tuple class by calling its class constructor, the code to do so can be cumbersome. L’exemple suivant utilise un constructeur de classe pour créer un tuple 7 ou septuple qui contient les données de remplissage de New York City pour chaque recensement de 1950 à 2000.The following example uses a class constructor to create a 7-tuple or septuple that contains population data for New York City for each census from 1950 through 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
' Create a 7-tuple.
Dim population As New Tuple(Of String, Integer, Integer, Integer, Integer, Integer, Integer) _
                           ("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

La création du même objet Tuple à l’aide d’une méthode d’assistance est plus simple, comme le montre l’exemple suivant.Creating the same tuple object by using a helper method is more straightforward, as the following example shows.

// 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
' Create a 7-tuple.
Dim 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

Les Create méthodes d’assistance prennent directement en charge la création d’objets tuples qui ont de un à huit composants (c’est-à-dire des singletons via octuples).The Create helper methods directly support the creation of tuple objects that have from one to eight components (that is, singletons through octuples). Bien qu’il n’y ait pas de limite pratique au nombre de composants qu’un tuple peut avoir, les méthodes d’assistance ne sont pas disponibles pour créer un tuple avec neuf composants ou plus.Although there is no practical limit to the number of components a tuple may have, helper methods are not available to create a tuple with nine or more components. Pour créer ce type de tuple, vous devez appeler Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> le constructeur.To create such a tuple, you must call the Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> constructor.

Notes

Pour obtenir des informations supplémentaires et des exemples qui utilisent des tuples, consultez la documentation pour les types de tuples individuels dans le .NET Framework.For additional information and examples that use tuples, see the documentation for the individual tuple types in the .NET Framework. Celles-ci sont répertoriées dans la section Voir aussi à la fin de cette rubrique.These are listed in the See Also section at the end of this topic.

Méthodes

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

Crée un objet de 8 tuples, ou octuple.Creates a new 8-tuple, or octuple.

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

Crée un objet de 7 tuples, ou septuple.Creates a new 7-tuple, or septuple.

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

Crée un objet de 6 tuples, ou sextuple.Creates a new 6-tuple, or sextuple.

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

Crée un objet de 5 tuples, ou quintuple.Creates a new 5-tuple, or quintuple.

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

Crée un objet de 4 tuples, ou quadruple.Creates a new 4-tuple, or quadruple.

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

Crée un objet de 3 tuples, ou triple.Creates a new 3-tuple, or triple.

Create<T1,T2>(T1, T2) Create<T1,T2>(T1, T2) Create<T1,T2>(T1, T2) Create<T1,T2>(T1, T2)

Crée un objet de 2 tuples, ou paire.Creates a new 2-tuple, or pair.

Create<T1>(T1) Create<T1>(T1) Create<T1>(T1) Create<T1>(T1)

Crée un objet de 1 tuple, ou singleton.Creates a new 1-tuple, or singleton.

S’applique à

Voir aussi