Value tuples - .NET (original) (raw)
A value tuple is a data structure that has a specific number and sequence of values. .NET provides the following built-in value tuple types:
- The ValueTuple structure represents a value tuple that has one element.
- The ValueTuple<T1,T2> structure represents a value tuple that has two elements.-
- The ValueTuple<T1,T2,T3> structure represents a value tuple that has three elements.
- The ValueTuple<T1,T2,T3,T4> structure represents a value tuple that has four elements.
- The ValueTuple<T1,T2,T3,T4,T5> structure represents a value tuple that has five elements.
- The ValueTuple<T1,T2,T3,T4,T5,T6> structure represents a value tuple that has six elements.
- The ValueTuple<T1,T2,T3,T4,T5,T6,T7> structure represents a value tuple that has seven elements.
- The ValueTuple<T1,T2,T3,T4,T5,T6,T7,TRest> structure represents a value tuple that has eight or more elements.
The value tuple types differ from the tuple types (such as Tuple<T1,T2>) as follows:
- They are structures (value types) rather than classes (reference types).
- Members such as Item1 and Item2 are fields rather than properties.
- Their fields are mutable rather than read-only.
The value tuple types provide the runtime implementation that supports tuples in C# and struct tuples in F#. In addition to creating a ValueTuple<T1,T2> instance by using language syntax, you can call the Create factory method.