C# · Essencial · Inglês · Técnico
named argument
Sintaxe que passa um argumento indicando o nome do parâmetro (nome: valor), em qualquer ordem. Deixa a chamada mais legível, sobretudo com booleanos e parâmetros opcionais.
Onde usar
Aparece em chamadas como Salvar(ativo: true, notificar: false), em que valores soltos seriam ilegíveis. Em code reviews, é a sugestão clássica para parâmetros bool.
Em código
void Enviar(string para, bool urgente = false,
int tentativas = 3) { }
Enviar("ana@x.com", tentativas: 5);
Enviar(urgente: true, para: "bob@x.com");Exemplos
Use a named argument so the boolean is readable.
Use um argumento nomeado para o booleano ficar legível.
Renaming that parameter breaks callers using named arguments.
Renomear esse parâmetro quebra quem usa argumentos nomeados.
Cuidado
Não renomeie parâmetros de API pública sem cuidado: quem usa argumento nomeado quebra na recompilação.
Sinônimos
argumento nomeado
Antônimos
argumento posicional