Propriedades (Guia de programação do C#)

Artigo
08/25/2010

As propriedades são membros que fornecem um mecanismo flexível para ler, gravar ou calcular os valores dos campos particulares.Propriedades podem ser usadas sistema autônomo se eles são membros de dados públicos, mas eles são métodos realmente especiais chamados acessadores.Isso permite que dados sejam acessados com facilidade e ainda ajuda a elevar a segurança e a flexibilidade de métodos.

Neste exemplo, a TimePeriod classe armazena um período de time. Internamente a classe armazena o time em segundos, mas uma propriedade chamada Hours permite que um cliente especificar um horário em horas. Os acessadores para o Hours propriedade executar a conversão entre as horas e segundos.

Exemplo

class TimePeriod
{
    private double seconds;

    public double Hours
    {
        get { return seconds / 3600; }
        set { seconds = value * 3600; }
    }
}


class Program
{
    static void Main()
    {
        TimePeriod t = new TimePeriod();

        // Assigning the Hours property causes the 'set' accessor to be called.
        t.Hours = 24;

        // Evaluating the Hours property causes the 'get' accessor to be called.
        System.Console.WriteLine("Time in hours: " + t.Hours);
    }
}
// Output: Time in hours: 24

Visão geral de propriedades

As propriedades permitem uma classe para expor uma pública maneira de obter e definir valores, enquanto oculta a implementação ou a verificação de código.
A obter acessador de propriedade é usado para retornar o valor da propriedade e um conjunto acessador é usado para atribuir um novo valor.Esses acessadores podem ter diferentes níveis de acesso.Para obter mais informações, consulte Assimétrico acessador acessibilidade (guia de programação translation from VPE for Csharp).
The valor palavra-chave é usada para definir o valor que está sendo atribuído pelo set indexador.
Propriedades que não implementam um set método são somente leitura.
Para propriedades simples que não exigem nenhum código personalizado acessador, considere a opção de usar as propriedades implementadas automaticamente.Para obter mais informações, consulte Propriedades implementado automática (guia de programação translation from VPE for Csharp).