Partilhar via


field - Declarações de propriedade apoiadas em campo

Use a palavra-chave fieldcontextual , introduzida em C# 14, num acessor de propriedades para aceder ao campo de suporte sintetizado pelo compilador de uma propriedade. Ao usar esta sintaxe, pode definir o corpo de um get acessório ou set e deixar que o compilador gere o outro acessório como faria numa propriedade implementada automaticamente.

A referência da linguagem C# documenta a versão mais recentemente lançada da linguagem C#. Contém também documentação inicial para funcionalidades em versões preliminares públicas para a próxima versão da linguagem.

A documentação identifica qualquer funcionalidade introduzida pela primeira vez nas últimas três versões da língua ou em pré-visualizações públicas atuais.

Sugestão

Para saber quando uma funcionalidade foi introduzida pela primeira vez em C#, consulte o artigo sobre o histórico de versões da linguagem C#.

A adição da field palavra-chave contextual proporciona um caminho suave para adicionar benefícios, como a 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 faça verificação de alcance no set acessório. Não precisas de declarar manualmente o campo de apoio ou fornecer um corpo para o get acessório.

Para obter mais informações, consulte 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 do C#.