Restringindo a acessibilidade do acessador (C# guia de programação)

Artigo
08/04/2011

O obter e set são chamados de partes de uma propriedade ou indexador acessadores. Por padrão, esses acessadores têm a mesma visibilidade ou nível de acesso: o que de propriedade ou indexador às quais eles pertencem. Para obter mais informações, consulte os níveis de acessibilidade. No entanto, algumas vezes é útil restringir o acesso a um desses acessadores. Normalmente, isso envolve a restringir a acessibilidade da set acessador, e manter o get publicamente acessível do acessador. Por exemplo:

private string name = "Hello";

public string Name
{
    get
    {
        return name;
    }
    protected set
    {
        name = value;
    }
}

Neste exemplo, uma propriedade chamada Name define um get e set acessador. O get acessador recebe o nível de acessibilidade da propriedade propriamente dito, public nesse caso, enquanto o set acessador explicitamente é restrito, aplicando a protegido modificador de acesso para o acessador propriamente dito.

Restrições de modificadores de acesso nos assessores

Usar os modificadores de assessor em propriedades ou indexadores está sujeita às seguintes condições:

Não é possível usar modificadores de assessor em uma interface ou um explícito interface a implementação de membro.
Você pode usar modificadores de assessor somente se a propriedade ou indexador tem dois set e get acessadores. Nesse caso, o modificador é permitido em um só dos acessadores de dois.
Se a propriedade ou indexador tiver um Substituir modificador, o modificador de acesso deve coincidir com o acessador de acessador substituído, se houver.
O nível de acessibilidade no acessador deve ser mais restritivo que o nível de acessibilidade na propriedade ou indexador propriamente dito.

Modificadores de acesso em substituindo acessadores

Quando você substitui uma propriedade ou indexador, os acessadores substituídos devem ser acessíveis para o código de substituição. Além disso, o nível de acessibilidade de tanto o propriedade/indexador e que os acessadores devem corresponder correspondente substituído propriedade/indexador e os acessadores. Por exemplo:

public class Parent
{
    public virtual int TestProperty
    {
        // Notice the accessor accessibility level.
        protected set { }

        // No access modifier is used here.
        get { return 0; }
    }
}
public class Kid : Parent
{
    public override int TestProperty
    {
        // Use the same accessibility level as in the overridden accessor.
        protected set { }

        // Cannot use access modifier here.
        get { return 0; }
    }
}

Implementar Interfaces

Quando você usa um acessador para implementar uma interface, o acessador não pode ter um modificador de acesso. No entanto, se você implementar a interface usando um acessador, como get, o acessador outro pode ter um modificador de acesso, como no exemplo a seguir:

public interface ISomeInterface
{
    int TestProperty
    {
        // No access modifier allowed here
        // because this is an interface.
        get;
    }
}

public class TestClass : ISomeInterface
{
    public int TestProperty
    {
        // Cannot use access modifier here because
        // this is an interface implementation.
        get { return 10; }

        // Interface property does not have set accessor,
        // so access modifier is allowed.
        protected set { }
    }
}

Domínio de acessibilidade do acessador

Se você usar um modificador de acesso no acessador, o o domínio de acessibilidade do acessador é determinada por esse modificador.

Se você não usou um modificador de acesso em o acessador, o domínio de acessibilidade do acessador é determinado pelo nível de acessibilidade da propriedade ou indexador.

Exemplo

O exemplo a seguir contém três classes, BaseClass, DerivedClass, e MainClass. Há duas propriedades sobre o BaseClass, Name e Id em ambas as classes. O exemplo demonstra como a propriedade Id em DerivedClass pode ser oculto pela propriedade Id em BaseClass Quando você usa um modificador de acesso restritivas como protegido ou particular. Portanto, quando você atribuir valores a essa propriedade, a propriedade de BaseClass classe é chamada em vez disso. Substituindo o modificador de acesso por pública fará com que a propriedade acessíveis.

O exemplo também demonstra que um modificador de acesso restritivas, como private ou protecteddiante a set acessador da Name propriedade na DerivedClass impede o acesso para o acessador e gera um erro quando você atribui a proprietário.

public class BaseClass
{
    private string name = "Name-BaseClass";
    private string id = "ID-BaseClass";

    public string Name
    {
        get { return name; }
        set { }
    }

    public string Id
    {
        get { return id; }
        set { }
    }
}

public class DerivedClass : BaseClass
{
    private string name = "Name-DerivedClass";
    private string id = "ID-DerivedClass";

    new public string Name
    {
        get
        {
            return name;
        }

        // Using "protected" would make the set accessor not accessible. 
        set
        {
            name = value;
        }
    }

    // Using private on the following property hides it in the Main Class.
    // Any assignment to the property will use Id in BaseClass.
    new private string Id
    {
        get
        {
            return id;
        }
        set
        {
            id = value;
        }
    }
}

class MainClass
{
    static void Main()
    {
        BaseClass b1 = new BaseClass();
        DerivedClass d1 = new DerivedClass();

        b1.Name = "Mary";
        d1.Name = "John";

        b1.Id = "Mary123";
        d1.Id = "John123";  // The BaseClass.Id property is called.

        System.Console.WriteLine("Base: {0}, {1}", b1.Name, b1.Id);
        System.Console.WriteLine("Derived: {0}, {1}", d1.Name, d1.Id);

        // Keep the console window open in debug mode.
        System.Console.WriteLine("Press any key to exit.");
        System.Console.ReadKey();
    }
}
/* Output:
    Base: Name-BaseClass, ID-BaseClass
    Derived: John, ID-BaseClass
*/