0Pricing
C# Academy · Leçon

Le modificateur required

Forcez les appelants à définir les propriétés essentielles.

Le modificateur required est une leçon C# Academy gratuite sur CoddyKit. Ceci est la leçon 2 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage C# Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours C# Academy comprend 4 leçons au total.

Le modificateur required

Le modificateur required oblige les appelants à définir une propriété ou un champ lors de la création d’un objet. Les erreurs « vous avez oublié une valeur » passent ainsi de l’exécution à la compilation.

using System;

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

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

Omettre un membre required empêche la compilation

Si un appelant omet un membre required, le compilateur signale une erreur avant même l’exécution du programme.

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 avec init

required s’associe naturellement à init : la valeur doit être fournie lors de la construction et ne peut plus être modifiée ensuite.

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 avec set

Vous pouvez également rendre obligatoire une propriété accessible en écriture. Elle doit être initialisée, mais peut encore être modifiée par la suite.

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

Champs required

Les champs peuvent eux aussi être required, et pas seulement les propriétés.

using System;

class Token {
    public required string Value;
}

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

Constructeurs et required

Si un constructeur définit un membre required, les appelants qui utilisent ce constructeur ne sont plus obligés de le définir. Utilisez [SetsRequiredMembers] pour l’indiquer au compilateur.

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

Mélanger required et facultatif

Seuls les membres que vous marquez sont obligatoires ; les autres restent facultatifs et utilisent leurs valeurs par défaut.

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 dans l’héritage

Les membres required sont hérités. Une classe dérivée peut ajouter ses propres membres required, et tous doivent être définis.

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

Remplacer les constructeurs lourds

required + init remplace souvent les constructeurs volumineux : vous obtenez des membres obligatoires avec la syntaxe lisible des initialiseurs d’objet.

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

Une intention explicite

Le marquage des membres required indique quelles valeurs sont essentielles, ce qui facilite l’utilisation correcte du type.

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

Mise en pratique

Un type qui associe des membres required, facultatifs et validés.

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

Vérification rapide

Vérifiez ce que garantit le modificateur required.

Récapitulatif

Vous avez appris à utiliser le modificateur required.

  • Il oblige les appelants à initialiser le membre lors de la création, ce que vérifie le compilateur.
  • Il s’associe à init pour créer des membres immuables obligatoires.
  • [SetsRequiredMembers] permet à un constructeur de satisfaire cette exigence.
  • Les membres required sont hérités.

Questions Fréquemment Posées

La leçon « Le modificateur required » est-elle gratuite ?

Oui — le texte complet de « Le modificateur required » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours C# Academy, passe à CoddyKit PRO. Le cours C# Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Le modificateur required » ?

Forcez les appelants à définir les propriétés essentielles. Tu pratiques C# Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer C# Academy ?

Aucune expérience préalable n'est requise. C# Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 2 sur 4.

Combien de temps prend la leçon « Le modificateur required » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon C# Academy ?

Oui. Chaque leçon C# Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

  1. Accesseurs init uniquement
  2. Le modificateur required
  3. Modèles d’objets immuables
  4. Expressions with sur les enregistrements
← Retour à C# Academy