Tuple Klas

Definitie

Naamruimte:
System
Assembly's:
mscorlib.dll, System.Runtime.dll
Assembly's:
netstandard.dll, System.Runtime.dll
Assembly:
System.Runtime.dll
Assembly:
mscorlib.dll
Assembly:
netstandard.dll
Bron:
Tuple.cs
Bron:
Tuple.cs
Bron:
Tuple.cs
Bron:
Tuple.cs
Bron:
Tuple.cs

Biedt statische methoden voor het maken van tuple-objecten.

public ref class Tuple abstract sealed
public static class Tuple
type Tuple = class
Public Class Tuple
Overname
Object
Tuple

Voorbeelden

In het volgende voorbeeld wordt een 8-tuple (octuple) gemaakt die priemgetallen bevat die kleiner zijn dan 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

open System

let primes = Tuple.Create(2, 3, 5, 7, 11, 13, 17, 19)
printfn $"Prime numbers less than 20: {primes.Item1}, {primes.Item2}, {primes.Item3}, {primes.Item4}, {primes.Item5}, {primes.Item6}, {primes.Item7}, and {primes.Rest.Item1}"
//    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

Opmerkingen

Een tuple is een gegevensstructuur met een specifiek aantal en een bepaalde reeks elementen. Een voorbeeld van een tuple is een gegevensstructuur met drie elementen (ook wel een drie-tuple of drievoudig genoemd) die wordt gebruikt voor het opslaan van een id, zoals de naam van een persoon in het eerste element, een jaar in het tweede element en het inkomen van de persoon voor dat jaar in het derde element. Het .NET Framework biedt rechtstreeks ondersteuning voor tuples met één tot zeven elementen. Daarnaast kunt u tuples van acht of meer elementen maken door tuple-objecten te nesten in de Rest eigenschap van een Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> object.

Tuples worden op vier manieren gebruikt:

  • Eén set gegevens weergeven. Een tuple kan bijvoorbeeld een databaserecord vertegenwoordigen en de bijbehorende onderdelen kunnen afzonderlijke velden van de record vertegenwoordigen.

  • Om eenvoudig toegang te bieden tot en manipulatie van een gegevensset.

  • Meerdere waarden van een methode retourneren zonder out parameters (in C#) of ByRef parameters (in Visual Basic).

  • Meerdere waarden doorgeven aan een methode via één parameter. De Thread.Start(Object) methode heeft bijvoorbeeld één parameter waarmee u één waarde kunt opgeven voor de methode die de thread tijdens het opstarten uitvoert. Als u een Tuple<T1,T2,T3> object opgeeft als het methodeargument, kunt u de opstartroutine van de thread opgeven met drie gegevensitems.

De Tuple klasse vertegenwoordigt zelf geen tuple. In plaats daarvan is het een klasse die statische methoden biedt voor het maken van exemplaren van de tuple-typen die worden ondersteund door het .NET Framework. Het biedt helpermethoden die u kunt aanroepen om tuple-objecten te instantiëren zonder expliciet het type tuple-onderdeel op te geven.

Hoewel u een instantie van een tuple-klasse kunt maken door de bijbehorende klasseconstructor aan te roepen, kan de code omslachtig zijn. In het volgende voorbeeld wordt een klasseconstructor gebruikt om een 7-tuple of septuple te maken die populatiegegevens voor New York City bevat voor elke telling van 1950 tot en met 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.
let population = Tuple<string, int, int, int, int, int, int>(
                            "New York", 7891957, 7781984, 
                            7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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

Het maken van hetzelfde tuple-object met behulp van een helpermethode is eenvoudiger, zoals in het volgende voorbeeld wordt weergegeven.

// 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.
let population = Tuple.Create("New York", 7891957, 7781984, 7894862, 7071639, 7322564, 8008278)
// Display the first and last elements.
printfn $"Population of {population.Item1} in 2000: {population.Item7:N0}"
// 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

De Create helpermethoden ondersteunen het maken van tuple-objecten met een tot acht onderdelen (dat wil gezegd, singletons tot octuples). Hoewel er geen praktische limiet is voor het aantal onderdelen dat een tuple kan hebben, zijn helpermethoden niet beschikbaar voor het maken van een tuple met negen of meer onderdelen. Als u een dergelijke tuple wilt maken, moet u de Tuple<T1,T2,T3,T4,T5,T6,T7,TRest>.Tuple<T1,T2,T3,T4,T5,T6,T7,TRest> constructor aanroepen.

Note

Zie de documentatie voor de afzonderlijke tupletypen in het .NET Framework voor aanvullende informatie en voorbeelden die gebruikmaken van tuples. Deze worden vermeld in de sectie Zie ook aan het einde van dit onderwerp.

Methoden

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

Hiermee maakt u een nieuwe 8-tuple of octuple.
Create<T1,T2,T3,T4,T5,T6,T7>(T1, T2, T3, T4, T5, T6, T7)

Hiermee maakt u een nieuwe 7-tuple of septuple.
Create<T1,T2,T3,T4,T5,T6>(T1, T2, T3, T4, T5, T6)

Hiermee maakt u een nieuwe 6-tuple of sextuple.
Create<T1,T2,T3,T4,T5>(T1, T2, T3, T4, T5)

Hiermee maakt u een nieuwe 5-tuple of quintuple.
Create<T1,T2,T3,T4>(T1, T2, T3, T4)

Hiermee maakt u een nieuwe 4-tuple of viervoudige.
Create<T1,T2,T3>(T1, T2, T3)

Hiermee maakt u een nieuwe 3-tuple of drie keer.
Create<T1,T2>(T1, T2)

Hiermee maakt u een nieuwe 2-tuple of een nieuw paar.
Create<T1>(T1)

Hiermee maakt u een nieuwe 1-tuple of singleton.

Van toepassing op

Zie ook