Кортежи появились в C# начиная с версии 7.0 с целью обеспечения работы с наборами значений. Основное предназначение кортежей - обобщение нескольких элементов в структуру с упрощенным синтаксисом. Для использования кортежей необходим тип System.ValueTuple. Для использования кортежей в более ранних версиях .NET Framework в проект необходимо добавить NuGet пакет SystemValueTuple.

Основные свойства кортежей:

• кортежи определяются с неограниченным количеством элементов.

• Кортежи являются типом значений.

• Кортежи поддерживают операторы = и !=

• Значения кортежей являются общедоступными полями.

var tuple1 = (10, 23.4); //Определен кортеж tuple1 с двумя значениями 10 и 23.4

Обращение к значениям кортежа происходит через поля с названиями типа Item[номер], где номер - порядковый номер значения в кортеже. Рассмотрим на примере программы:

static void Main(string[] args)
{
  int tuple1 = (11, 33);						//Определение кортежа с целочисленными значениями
  Console.WriteLine(tuple1.Item1);	//Вывод на консоль 11
  tuple1.Item2 *= 2;								//Умножение второго значения на 2
}

Возможно определение типа для каждого из значений. Для этого перед именем кортежа в скобках указываются типы для каждого значения.

(string, int) tuple = ("Coin", 25);

Для каждого значения кортежа предусмотрена возможность индивидуального именования. Заданное имя элемента называется именем кандидата. Оно является дубликатором другого явного или неявного имени поля кортежа.

var tuple1 = (purchase:5, sale:10);
Console.WriteLine(tuple1.purchase);

Для определения кортежей можно применять переменные, с которыми в дальнейшем можно производить операции.

var (purchase, sale) = (5, 10);
Console.WriteLine(Purchase);

Применение кортежей

Кортежи могут передаваться в метод в качестве параметров и служить возвращаемым результатом. В частности, очень удобно возвращать кортеж в качестве результата в том случае, если метод возвращает только одно значение.

static void Main(string[] args)
{
    var tuple1 = Method();					//Присваиваем кортежу tuple1 возвращаемое значение
    Console.WriteLine(tuple1.Item1);
    Console.WriteLine(tuple1.Item2);     
}
private static (int, int) Method()	//Метод, возвращающий кортеж
{
    var res = (5, 10);
    return res;
}

В следующем примере кортеж передается в метод в качестве параметра.

static void Main(string[] args)
{
  var (purchase, sale) = Method ((5, 10), 3);
  Console.WriteLine($"Purchase: {purchase} Sale: {sale}");
}

private static (int purchase, int sale) Method((int p, int s)tuple, int n)
{
  var res = (purchase: tuple.p, sale: tuple.s + n);
  return result;
}

Присваивание кортежей

В кортежах предусмотрена возможность присваивания. Для этого оба кортежа должны иметь одинаковое количество элементов, типы соответствующих значений должны совпадать или иметь возможность неявного приведения друг к другу. Значения присваиваются в порядке их расположения. При присвоении имена полей не учитываются.

(int, int) tuple1 = (22, 12);
(double A, double B) tuple2 = (2.15, 3,02);
tuple2 = tuple1;

Деконструкция кортежей

Деконструкцией кортежей называется операция присваивания экземпляра кортежа в отдельные переменные.

var tuple = ("Alex", 36);
(string name, int age) = tuple;
//или
string name;
int age;
(name, age) = tuple;

Проверка кортежей на равенство

var tuple1 = (23, 36);
var tuple2 = (17, 31);
Console.WriteLine(tuple1 == tuple2);
Console.WriteLine(tuple1 != tuple2);

Имена полей кортежей при сравнении не учитываются.

Условия возможности сравнения кортежей:

• Оба кортежа содержат одинаковое количество элементов.

• Элементы должны соответствовать возможности сравнения.

Кортежи в качестве параметров вывода

При выполнении рефакторинга метода, имеющего параметры out они могут иметь тип кортежа.

var limitsLookup = new Dictionary<int, (int Min, int Max)>()
{
    [2] = (4, 10),
    [4] = (10, 20),
    [6] = (0, 23)
};

if (limitsLookup.TryGetValue(4, out (int Min, int Max) limits))
{
    Console.WriteLine($"Found limits: min is {limits.Min}, max is {limits.Max}");
}

Различия между типами кортежей System.ValueTuple и SystemTuple

Основные различия заключаются в следующем:

• Типы ValueTuple являются типами значений - типы Tuple - ссылочные типы.

• Типы ValueTuple являются изменяемыми типами - типы Tuple - неизменяемые.

• Значениями типов ValueTuple являются поля. Значениями типов Tuple являются свойства.