init (Referência C#)

  • Artigo

A init palavra-chave define um método de acessador em uma propriedade ou indexador. Um setter init-only atribui um valor à propriedade ou ao elemento indexador somente durante a construção do objeto. Um init impõe a imutabilidade, de modo que, uma vez que o objeto é inicializado, ele não pode ser alterado. Um init acessador permite que o código de chamada use um inicializador de objeto para definir o valor inicial. Por outro lado, uma propriedade implementada automaticamente com apenas um get setter deve ser inicializada chamando um construtor. Um imóvel com acessório private set pode ser modificado após a construção, mas apenas na classe.

O exemplo a seguir define um get e um init acessador para uma propriedade chamada YearOfBirth. Ele usa um campo privado nomeado _yearOfBirth para apoiar o valor da propriedade.

class Person_InitExample
{
     private int _yearOfBirth;

     public int YearOfBirth
     {
         get { return _yearOfBirth; }
         init { _yearOfBirth = value; }
     }
}

Muitas vezes, o init acessador consiste em uma única instrução que atribui um valor, como fez no exemplo anterior. initDevido ao , o seguinte não funciona:

var john = new Person_InitExample
{
    YearOfBirth = 1984
};

john.YearOfBirth = 1926; //Not allowed, as its value can only be set once in the constructor

Um init acessador não força os chamadores a definir a propriedade. Em vez disso, ele permite que os chamadores usem um inicializador de objeto, proibindo modificações posteriores. Você pode adicionar o modificador para forçar os required chamadores a definir uma propriedade. O exemplo a seguir mostra uma init propriedade only com um tipo de valor anulável como seu campo de apoio. Se um chamador não inicializar a YearOfBirth propriedade, essa propriedade terá o valor padrão null :

class Person_InitExampleNullability
{
    private int? _yearOfBirth;

    public int? YearOfBirth
    {
        get => _yearOfBirth;
        init => _yearOfBirth = value;
    }
}

Para forçar os chamadores a definir um valor inicial não nulo, adicione o required modificador, conforme mostrado no exemplo a seguir:

class Person_InitExampleNonNull
{
    private int _yearOfBirth;

    public required int YearOfBirth
    {
        get => _yearOfBirth;
        init => _yearOfBirth = value;
    }
}

O init acessador pode ser usado como um membro com corpo de expressão. Exemplo:

class Person_InitExampleExpressionBodied
{
    private int _yearOfBirth;

    public int YearOfBirth
    {
        get => _yearOfBirth;
        init => _yearOfBirth = value;
    }
}

O init acessador também pode ser usado em propriedades autoimplementadas, como o código de exemplo a seguir demonstra:

class Person_InitExampleAutoProperty
{
    public int YearOfBirth { get; init; }
}

O exemplo a seguir mostra a distinção entre um private set, somente leitura e init propriedade. Tanto a versão do conjunto privado quanto a versão somente leitura exigem que os chamadores usem o construtor adicionado para definir a propriedade name. A private set versão permite que uma pessoa altere seu nome depois que a instância é construída. A init versão não requer um construtor. Os chamadores podem inicializar as propriedades usando um inicializador de objeto:

class PersonPrivateSet
{
    public string FirstName { get; private set; }
    public string LastName { get; private set; }
    public PersonPrivateSet(string first, string last) => (FirstName, LastName) = (first, last);

    public void ChangeName(string first, string last) => (FirstName, LastName) = (first, last);
}

class PersonReadOnly
{
    public string FirstName { get; }
    public string LastName { get; }
    public PersonReadOnly(string first, string last) => (FirstName, LastName) = (first, last);
}

class PersonInit
{
    public string FirstName { get; init; }
    public string LastName { get; init; }
}

PersonPrivateSet personPrivateSet = new("Bill", "Gates");
PersonReadOnly personReadOnly = new("Bill", "Gates");
PersonInit personInit = new() { FirstName = "Bill", LastName = "Gates" };

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