Добавление описания для каждого объекта Tuple?

Question

У меня есть кортеж:

var a = new Tuple<int, int, int>(1,2,3); 

Мой вопрос:

есть ли способ (по /// remark или что-то еще), чтобы добавить краткое описание к типам объектов?

первый 3 INT в может сбивать с толку ....

Как я могу знать, что item1 имеет в виду «возраст» и не «Количество пальцев»?

Answer 1

порядка № Tuple класс предназначен только для внутреннего использования в рамках метода; если вы намерены сделать доступными данные публично, вы должны определить class или struct со свойствами для каждого из ваших значений.

Однако, если вы хотите дать значимые имена своим значениям, вместо этого вы можете использовать анонимные типы. Это ограничено (не только предназначено) только для внутреннего использования внутри метода.

var a = new { Name = "ABC", Age = 33, NumberOfFingers = 10 }; 
int age = a.Age; 

Edit: Если вы убеждены, что вы хотите, чтобы вернуть кортеж из метода, то мое предложение было бы объяснить его структуру в документации для возвращаемого значения вашего метода ,

/// <summary> 
/// Retrieves personal information about the person. 
/// </summary> 
/// <returns> 
/// A tuple containing the following information: 
/// <list type="bullet"> 
/// <item><see cref="Tuple{T1,T2,T3}.Item1"/>: The name of the person.</item> 
/// <item><see cref="Tuple{T1,T2,T3}.Item2"/>: The age of the person.</item> 
/// <item><see cref="Tuple{T1,T2,T3}.Item3"/>: The number of fingers the person has.</item> 
/// </list> 
/// </returns> 
public Tuple<string, int, int> GetPerson() 
{ 
    return Tuple.Create("ABC", 33, 10); 
} 

Если вы хотите, чтобы показать в IntelliSense, поместите ваше объяснение в <summary>.

Answer 2

Нет, это невозможно - вы не можете документировать переданные параметры.

Это один из больших недостатков использования Tuple - смысл значений довольно непрозрачен.

Предлагаю написать класс/структуру с содержательными именами и использовать это вместо этого.