C# Language
Именованные аргументы

Именованные аргументы могут сделать ваш код более понятным

Рассмотрим этот простой класс:

class SmsUtil
{
    public bool SendMessage(string from, string to, string message, int retryCount, object attachment)
    {
         // Some code
    }
}

До C # 3.0 это было:

var result = SmsUtil.SendMessage("Mehran", "Maryam", "Hello there!", 12, null);

вы можете сделать этот метод более понятным с помощью именованных аргументов :

var result = SmsUtil.SendMessage(
    from: "Mehran",
    to:  "Maryam",
    message "Hello there!",
    retryCount: 12,
    attachment: null);

Именованные аргументы и необязательные параметры

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

Давайте посмотрим на этот метод:

public sealed class SmsUtil
{
    public static bool SendMessage(string from, string to, string message, int retryCount = 5, object attachment = null)
    {
         // Some code
    }
}

Если вы хотите вызвать этот метод без аргумента retryCount :

var result = SmsUtil.SendMessage(
                        from       : "Cihan",
                        to         : "Yakar",
                        message    : "Hello there!",
                        attachment : new object());

Аргумент не нужен

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

Пример метода:

public static string Sample(string left, string right)
{
     return string.Join("-",left,right);
}

Образец вызова:

Console.WriteLine (Sample(left:"A",right:"B"));
Console.WriteLine (Sample(right:"A",left:"B"));

Результаты:

A-B
B-A

Именованные аргументы позволяют избежать ошибок по необязательным параметрам

Всегда используйте Named Arguments для дополнительных параметров, чтобы избежать возможных ошибок при изменении метода.

class Employee
{
    public string Name { get; private set; }

    public string Title { get; set; }

    public Employee(string name = "<No Name>", string title = "<No Title>")
    {
        this.Name = name;
        this.Title = title;
    }
}

var jack = new Employee("Jack", "Associate");   //bad practice in this line

Вышеприведенный код компилируется и работает нормально, пока конструктор не изменится, как:

//Evil Code: add optional parameters between existing optional parameters
public Employee(string name = "<No Name>", string department = "intern", string title = "<No Title>")
{
    this.Name = name;
    this.Department = department;
    this.Title = title;
}

//the below code still compiles, but now "Associate" is an argument of "department"
var jack = new Employee("Jack", "Associate");

Лучшая практика, чтобы избежать ошибок, когда «кто-то в команде» допустил ошибки:

var jack = new Employee(name: "Jack", title: "Associate");