Este artículo se tradujo automáticamente. Para ver el artículo en inglés, active la casilla Inglés. Además, puede mostrar el texto en inglés en una ventana emergente si mueve el puntero del mouse sobre el texto.
Traducción
Inglés

Clase Tuple

 

Publicado: octubre de 2016

Proporciona los métodos estáticos para crear objetos de tupla.

Para examinar el código fuente de .NET Framework para este tipo, consulte el Reference Source.

Espacio de nombres:   System
Ensamblado:  mscorlib (en mscorlib.dll)


public static class Tuple

NombreDescripción
System_CAPS_pubmethodSystem_CAPS_staticCreate<T1>(T1)

Crea una nueva tupla de 1 o singleton.

System_CAPS_pubmethodSystem_CAPS_staticCreate<T1, T2>(T1, T2)

Crea una nueva tupla de 2 o par.

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

Crea una nueva tupla de 3 o triple.

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

Crea una nueva tupla de 4 o cuádruplo.

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

Crea una nueva tupla de 5 o quíntuplo.

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

Crea una nueva tupla de 6 o séxtuplo.

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

Crea una nueva tupla de 7 o séptuplo.

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

Crea una nueva tupla de 8 u óctuple.

System_CAPS_noteNota

Para ver el código fuente de .NET Framework para este tipo, consulte el Reference Source. Puede examinar el código fuente en línea, descargar la referencia para visualizarlo sin conexión y paso a paso el código fuente (incluidas revisiones y actualizaciones) durante la depuración; see instructions.

Una tupla es una estructura de datos que tiene un número específico y la secuencia de elementos. Un ejemplo de una tupla es una estructura de datos con tres elementos (conocido como una tupla de 3 o triple) que se utiliza para almacenar un identificador como nombre de una persona en el primer elemento, un año en el segundo elemento y los ingresos de la persona de dicho año en el tercer elemento. .NET Framework admite directamente tuplas con uno y siete elementos. Además, puede crear tuplas de ocho o más elementos mediante el anidamiento de objetos de tupla en la propiedad Rest de un Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> objeto.

Tuplas se utilizan normalmente de cuatro maneras:

  • Para representar un único conjunto de datos. Por ejemplo, una tupla puede representar un registro de base de datos y sus componentes pueden representar campos individuales del registro.

  • Para proporcionar un acceso sencillo a y la manipulación de un conjunto de datos.

  • Para devolver varios valores de un método sin usar out parámetros (en C#) o ByRef parámetros (en Visual Basic).

  • Para pasar varios valores a un método a través de un solo parámetro. Por ejemplo, el Thread.Start(Object) método tiene un parámetro único que le permite proporcionar un valor para el método que el subproceso se ejecuta en tiempo de inicio. Si proporciona un Tuple<T1, T2, T3> objeto como el argumento del método, puede proporcionar la rutina de inicio del subproceso con tres elementos de datos.

La Tuple clase no propio representa una tupla. En su lugar, es una clase que proporciona métodos estáticos para crear instancias de los tipos de tupla que son compatibles con .NET Framework. Proporciona métodos auxiliares que puede llamar para crear instancias de objetos de tupla sin tener que especificar explícitamente el tipo de cada componente de la tupla.

Aunque puede crear una instancia de una clase de tupla mediante una llamada a su constructor de clase, el código para hacerlo puede ser complicado. En el ejemplo siguiente se utiliza un constructor de clase para crear una tupla de 7 o séptuplo que contiene datos de la población de la ciudad de Nueva York correspondientes a cada censo de 1950 a 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

Crear el mismo objeto de tupla con un método auxiliar es más sencillo, como se muestra en el ejemplo siguiente.

// 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

El Create métodos auxiliares admiten directamente la creación de objetos de tupla que tienen de uno a ocho componentes (es decir, desde singleton hasta óctuple). Aunque no hay ningún límite práctico para el número de componentes puede tener una tupla, métodos auxiliares no están disponibles para crear una tupla con nueve o más componentes. Para crear este tipo de tupla, debe llamar a la Tuple<T1, T2, T3, T4, T5, T6, T7, TRest>.Tuple<T1, T2, T3, T4, T5, T6, T7, TRest> constructor.

System_CAPS_noteNota

Para obtener información adicional y ejemplos que utilizan tuplas, consulte la documentación para los tipos de tupla individuales en .NET Framework. Se muestran en la sección Consulte también al final de este tema.

En el ejemplo siguiente se crea una tupla de 8 (óctuple) que contiene números primos menores que 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

Plataforma universal de Windows
Disponible desde 8
.NET Framework
Disponible desde 4.0
Biblioteca de clases portable
Se admite en: plataformas portátiles de .NET
Silverlight
Disponible desde 4.0
Windows Phone Silverlight
Disponible desde 8.0
Windows Phone
Disponible desde 8.1

Cualquier miembro ( Compartido en Visual Basic) estático público de este tipo es seguro para subprocesos. No se garantiza que los miembros de instancia sean seguros para subprocesos.

Volver al principio
Mostrar: