C# · Essencial · Inglês · Técnico
out parameter
Parâmetro marcado com out que o método é obrigado a atribuir antes de retornar, permitindo devolver mais de um valor; o chamador pode declará-lo na própria chamada.
Onde usar
É o padrão TryParse: int.TryParse(texto, out var n) evita exceção em entradas inválidas. Em APIs novas, tuplas ou records costumam ser mais legíveis que vários out.
Em código
if (int.TryParse("42", out var n)) {
Console.WriteLine(n + 1); // 43
}
if (!int.TryParse("abc", out _)) {
Console.WriteLine("inválido");
}Exemplos
Use TryParse with an out variable to avoid exceptions.
Use TryParse com uma variável out para evitar exceções.
Discard the out parameter with an underscore.
Descarte o parâmetro out com um underscore.
Cuidado
Não confunda com ref: no out a variável não precisa estar inicializada na entrada, mas o método precisa atribuí-la em todos os caminhos.
Sinônimos
parâmetro de saída