C# Academy · Aula

O modificador required

Force os chamadores a definir propriedades essenciais.

O modificador required é uma aula grátis de C# Academy no CoddyKit. Esta é a aula 2 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de C# Academy, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de C# Academy inclui 4 aulas no total.

O modificador required

O modificador required obriga quem chama a definir uma propriedade ou campo ao criar um objeto. Ele transfere os erros de "você esqueceu um valor" do tempo de execução para o tempo de compilação.

using System;

class Person {
    public required string Name { get; init; }
}

var p = new Person { Name = "Ada" };
Console.WriteLine(p.Name); // Ada

Omitir um membro required impede a compilação

Se quem chama deixar de informar um membro required, o compilador relatará um erro antes mesmo de o programa ser executado.

using System;

class Person {
    public required string Name { get; init; }
}

// var bad = new Person { }; // compile error: Name is required
var good = new Person { Name = "Lin" };
Console.WriteLine(good.Name); // Lin

required com inicialização

required combina naturalmente com init: o valor deve ser fornecido durante a construção e não pode ser alterado depois.

using System;

class Config {
    public required string Url { get; init; }
    public int Timeout { get; init; } = 30;
}

var c = new Config { Url = "https://api" };
Console.WriteLine(c.Url + " " + c.Timeout); // https://api 30

required com atribuição

Você também pode marcar como required uma propriedade que aceita atribuição. Ela deve ser inicializada, mas ainda poderá ser alterada posteriormente.

using System;

class Box {
    public required int Size { get; set; }
}

var b = new Box { Size = 5 };
b.Size = 10; // still mutable
Console.WriteLine(b.Size); // 10

Campos required

Os campos também podem ser required, não apenas as propriedades.

using System;

class Token {
    public required string Value;
}

var t = new Token { Value = "abc123" };
Console.WriteLine(t.Value); // abc123

Construtores e required

Se um construtor definir um membro required, quem usar esse construtor não precisará mais defini-lo. Use [SetsRequiredMembers] para informar isso ao compilador.

using System;
using System.Diagnostics.CodeAnalysis;

class Person {
    public required string Name { get; init; }
    [SetsRequiredMembers]
    public Person(string name) => Name = name;
}

Console.WriteLine(new Person("Sam").Name); // Sam

Combinando required e opcionais

Apenas os membros marcados por você são obrigatórios; os demais continuam opcionais e usam seus valores padrão.

using System;

class Account {
    public required string Owner { get; init; }
    public decimal Balance { get; init; } = 0m;
}

var a = new Account { Owner = "Kai" };
Console.WriteLine(a.Owner + " " + a.Balance); // Kai 0

required na herança

Os membros required são herdados. Uma classe derivada pode adicionar seus próprios membros required, e todos devem ser satisfeitos.

using System;

class Base { public required int Id { get; init; } }
class Item : Base { public required string Name { get; init; } }

var i = new Item { Id = 1, Name = "Pen" };
Console.WriteLine(i.Id + " " + i.Name); // 1 Pen

Substituindo construtores complexos

required + init frequentemente substitui construtores grandes: você obtém membros obrigatórios com a sintaxe legível de inicializador de objeto.

using System;

class Email {
    public required string To { get; init; }
    public required string Subject { get; init; }
    public string Body { get; init; } = "";
}

var e = new Email { To = "a@b.com", Subject = "Hi" };
Console.WriteLine(e.To + " | " + e.Subject); // a@b.com | Hi

Intenção autoexplicativa

Marcar membros como required documenta quais valores são essenciais, tornando o tipo mais fácil de usar corretamente.

using System;

class Registration {
    public required string Username { get; init; }
    public required string Password { get; init; }
    public bool Newsletter { get; init; }
}

var r = new Registration { Username = "ada", Password = "x" };
Console.WriteLine(r.Username); // ada

Combinando tudo

Um tipo que combina membros required, opcionais e validados.

using System;

class Server {
    public required string Host { get; init; }
    public int Port { get; init; } = 8080;
    public string Address => Host + ":" + Port;
}

var s = new Server { Host = "localhost" };
Console.WriteLine(s.Address); // localhost:8080

Verificação rápida

Confirme o que o modificador required garante.

Recapitulação

Você aprendeu sobre o modificador required.

Ele obriga quem chama a inicializar o membro ao criar o objeto, algo verificado pelo compilador.
Ele combina com init para criar membros imutáveis obrigatórios.
[SetsRequiredMembers] permite que um construtor satisfaça o requisito.
Os membros required são herdados.

Perguntas Frequentes

A aula “O modificador required” é grátis?

Sim — o texto completo de “O modificador required” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de C# Academy, atualize para CoddyKit PRO. O curso de C# Academy inclui 4 aulas no total.

O que vou aprender em “O modificador required”?

Force os chamadores a definir propriedades essenciais. Você pratica C# Academy com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.

Preciso ter experiência prévia para começar C# Academy?

Nenhuma experiência prévia é necessária. C# Academy no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 2 de 4.

Quanto tempo leva a aula “O modificador required”?

A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.

Posso escrever e executar código nesta aula de C# Academy?

Sim. Cada aula de C# Academy inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.

Todas as aulas deste curso

← Voltar para C# Academy