get (Referência C#)

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

O exemplo a seguir define um get e um set acessador para uma propriedade chamada Seconds. Ele usa um campo privado nomeado _seconds para apoiar o 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;
        }
    }
}

Muitas vezes, o get acessador consiste em uma única instrução que retorna um valor, como fez no exemplo anterior. Você pode implementar o get acessador como um membro com corpo de expressão. O exemplo a seguir implementa o get e o set acessador como membros com corpo de expressão.

class TimePeriod2
{
    private double _seconds;

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

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

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

Importante

As propriedades implementadas automaticamente não são permitidas para declarações de propriedade de interface ou declarações de propriedade parciais. Em ambos os casos, o compilador interpreta a sintaxe correspondente a uma propriedade implementada automaticamente como a declaração declarativa, não como uma declaração de implementação.

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

Consulte também