field - Declarações de propriedade com suporte de campo

Use a palavra-chave fieldcontextual, introduzida em C# 14, em um acessador de propriedade para acessar o campo de backup sintetizado pelo compilador de uma propriedade. Usando essa sintaxe, você pode definir o corpo de um get ou set acessador e permitir que o compilador gere o outro acessador como faria em uma propriedade implementada automaticamente.

A linguagem C# faz referência a documentos da versão mais recentemente lançada da linguagem C#. Ele também contém a documentação inicial para funcionalidades em pré-visualizações públicas para o próximo lançamento do idioma.

A documentação identifica qualquer recurso introduzido pela primeira vez nas três últimas versões do idioma ou nas versões prévias públicas atuais.

Dica

Para descobrir quando um recurso foi introduzido pela primeira vez em C#, consulte o artigo sobre o histórico de versão da linguagem C#.

A adição da field palavra-chave contextual fornece um caminho suave para adicionar benefícios, como verificação de intervalo a uma propriedade implementada automaticamente. Essa prática é mostrada no exemplo a seguir:

class TimePeriod4
{
    public double Hours {
        get;
        set => field = (value >= 0)
            ? value
            : throw new ArgumentOutOfRangeException(nameof(value), "The value must not be negative");
    }
}

Você pode implementar a propriedade como uma propriedade implementada Hours automaticamente. Então, você descobre que deseja se proteger contra um valor negativo. Use field e forneça verificação de intervalo no set acessador. Você não precisa declarar o campo de backup manualmente ou fornecer um corpo para o get acessador.

Para obter mais informações, confira os artigos Propriedades e Indexadores.

Especificação da linguagem C#

Para obter mais informações, consulte a Especificação da linguagem C#. A especificação da linguagem é a fonte definitiva para a sintaxe e o uso de C#.