Click here to Skip to main content
15,608,989 members
Articles / Programming Languages / C# 7.0
Technical Blog
Posted 1 Nov 2016

Tagged as


2 bookmarked

C# 7.0: Tuples to the Extreme!

Rate me:
Please Sign up or sign in to vote.
4.78/5 (6 votes)
1 Nov 2016CPOL3 min read
C#7.0: Tuples to the extreme!

C# 7.0 : Tuples to the Extreme!

Tuples are something that many developers may not frequently work with on a day-to-day basis, but they have a few different uses. With the latest upcoming release of C#, however this may change as tuples are getting a major power-up and will likely see quite a bit more "play" in the real-world.

So what is a Tuple?

If we go by the MSDN description :

A tuple is a data structure that has a specific number and sequence of elements. 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.

Or more basically, you can think of it as a class without any actual properties or something that you might use if you are too lazy to actually create a class to implement some type of behavior.

For example, let's say you wanted to create a class to store a City / State combination that you might pass around:

public class Location  
     public string City { get; set; }
     public string State { get; set; }

     public Location(string city, string state)
           City = city;
           State = state;

// Example
var location = new Location("Lake Charles","LA");  
// Print out the address
var address = $"{location.City}, {location.State}"; 

You could do the same thing with a Tuple, however you would obviously have much less descriptive things to work with:

var location = new Tuple<string,string>("Lake Charles","LA");  
// Print out the address
var address = $"{location.Item1}, {location.Item2}";  

So in some scenarios, especially quick and dirty ones, Tuple objects can be incredibly useful. MSDN also has a few common use cases that you might have wanted to look over as well.

Alright. So What's New with Tuples in C# 7.0?

Well, C# 7.0 introduces a feature that I know quite a few developers have been asking about for a while: multiple return values.

That's right, you can now write some code like the following without having to build a class, use a tuple, or a series of ref or out parameters:

public (string city, string state) GetCityAndState()  
    return ("Lake Charles","Louisiana");

This would allow you to make a call to a single method and access each of the return values by their defined names as seen below:

var result = GetCityAndState();  
var city =;  // yields "Lake Charles"  
var state = result.state // yields "Louisiana"  

The results of these multiple return value methods can also be deconstructed in a variety of ways based on your needs:

// Using two explicitly defined return values
(string city, string state) = GetCityAndState();
// Using var as opposed to explicit type definitions
(var city, var state) = GetCityAndState();
// Using a single var declaration for multiple variables
var (city, state) = GetCityAndState();  
// Using existing variables
(city,state) = GetCityAndState();

As you might imagine, initialization is going to roughly take a similar syntactic approach:

var location = ("Lake Charles", "Louisiana");  

This is a feature that a few other popular programming languages like Python, Scala, Ruby, Go and others have had for quite a while, so hopefully it will be a nice addition to C#.

Cool. Anything Else?

In addition to straight-forward examples like those provided, these new ValueTuple objects can use things like type inference to match up the signature of the return type and ensure it is valid like the following example:

public (string city, int population) FindBiggestCityWithPopulation(string state)  
    var result = (city: "", population: 0); = _someService.GetBiggestCity(state);
    result.population = _someService.GetPopulation(;
    return result;

Likewise, these new tuples also support the async/await pattern out of the box:

public async Task(string bird, string flower) GetStateBirdAndFlowerAsync(string state)  
    var bird = await _someService.GetStateBirdAsync(state);
    var flower = await _someService.GetStateFlower(state);
    return (bird,flower);

See How This Came To Be

One of the wonderful things about the "new" Microsoft development ecosystem is just how open it is. No longer are important development decisions made in dark, smoke-filled rooms, but rather in transparent issues on GitHub.

If you want to take a look at the conversation that lead up to this feature, you can visit the proposal for multiple return values here. You may also want to consider looking around through the other active issues to see what other features might be coming soon.

This article was originally posted at


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)

Written By
Software Developer (Senior)
United States United States
An experienced Software Developer and Graphic Designer with an extensive knowledge of object-oriented programming, software architecture, design methodologies and database design principles. Specializing in Microsoft Technologies and focused on leveraging a strong technical background and a creative skill-set to create meaningful and successful applications.

Well versed in all aspects of the software development life-cycle and passionate about embracing emerging development technologies and standards, building intuitive interfaces and providing clean, maintainable solutions for even the most complex of problems.

Comments and Discussions

QuestionOverhead of new features Pin
Budsy2-Nov-16 12:06
Budsy2-Nov-16 12:06 
AnswerRe: Overhead of new features Pin
Daniel Jursza14-Nov-16 6:49
Daniel Jursza14-Nov-16 6:49 
QuestionNice feature. Nice description Pin
Michael Breeden2-Nov-16 8:26
Michael Breeden2-Nov-16 8:26 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.