A palavra-chave get

A palavra-chave get define um método do acessador em uma propriedade ou um indexador que retorna o valor da propriedade ou o elemento do indexador. Para obter mais informações, consulte Propriedades, Propriedades implementadas automaticamentee Indexers.

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#.

Para casos simples em que uma propriedade get e set acessadores não executam nenhuma outra operação além de definir ou recuperar um valor em um campo de backup privado, aproveite o suporte do compilador C# para propriedades implementadas automaticamente. O exemplo a seguir é implementado como uma propriedade implementada Hours automaticamente.

class TimePeriod3
{
    public double Hours { get; set; }
}

Importante

Você não pode usar propriedades implementadas automaticamente para declarações de propriedade de interface ou a declaração de implementação para uma propriedade parcial. O compilador interpreta a sintaxe correspondente a uma propriedade implementada automaticamente como a declaração de declaração, não uma declaração de implementação.

Geralmente, o acessador get consiste em uma única instrução que retorna um valor, como no exemplo anterior. Você pode implementar o acessador get como um membro apto para expressão. O exemplo a seguir implementa os acessadores get e set como membros aptos para expressão.

class TimePeriod2
{
    private double _seconds;

    public double Seconds
    {
        get => _seconds;
        set => _seconds = value;
    }
}

Você pode achar que precisa implementar um dos corpos do acessador. Use uma propriedade com suporte de campo para permitir que o compilador gere um acessador enquanto você grava o outro manualmente. Use a field palavra-chave, adicionada no C# 14, para acessar o campo de backup sintetizado do compilador:

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

O exemplo a seguir define um acessador get e um acessador set para uma propriedade chamada Seconds. Ela usa um campo particular chamado _seconds para dar suporte ao valor da propriedade.

class TimePeriod
{
    private double _seconds;

    public double Seconds
    {
        get { return _seconds; }
        set
        {
            if (value < 0)
            {
                throw new ArgumentOutOfRangeException(nameof(value), "The value of the time period must be non-negative.");
            }
            _seconds = value;
        }
    }
}

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#.

Confira também

• Palavras-chave do C#
• Propriedades