C# · Essencial · Inglês · Técnico
as operator
Operador de conversão segura entre tipos de referência e anuláveis: devolve o objeto convertido ou null quando a conversão não é possível, sem lançar InvalidCastException.
Onde usar
Aparece em código legado que converte um tipo e depois testa if (x != null). Hoje o pattern matching com is faz o mesmo em um passo só e é mais claro.
Em código
object o = "texto";
string? s = o as string;
int? n = o as int?;
Console.WriteLine(s?.Length); // 5
Console.WriteLine(n is null); // TrueExemplos
The as operator returns null if the cast fails.
O operador as retorna null se a conversão falhar.
Use pattern matching instead of as plus a null check.
Use pattern matching em vez de as com checagem de null.
Cuidado
Não use quando o tipo errado seria um bug: o as esconde o erro em um null que estoura longe dali. Para isso use o cast direto (T)x.
Sinônimos
conversão segura
Antônimos
cast direto