C# Academy · Урок

Модификатор required

Требуйте от вызывающего кода задавать важные свойства.

«Модификатор required» — бесплатный урок C# Academy на CoddyKit. Это урок 2 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения C# Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс C# Academy содержит 4 уроков всего.

Модификатор required

Модификатор required заставляет вызывающий код задать свойство или поле при создании объекта. Благодаря этому ошибки «Вы забыли указать значение» возникают во время компиляции, а не во время выполнения.

using System;

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

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

Пропуск обязательного члена приводит к ошибке компиляции

Если вызывающий код не укажет обязательный член, компилятор сообщит об ошибке ещё до запуска программы.

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 и инициализация

required естественно сочетается с init: значение необходимо указать при создании объекта, и после этого его нельзя изменить.

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 и присваивание

Вы также можете сделать обязательным свойство, допускающее присваивание. Его необходимо инициализировать, но позднее его всё ещё можно изменить.

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

Обязательные поля required

Обязательными могут быть не только свойства, но и поля.

using System;

class Token {
    public required string Value;
}

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

Конструкторы и required

Если конструктор задаёт обязательный член, вызывающему коду, использующему этот конструктор, больше не нужно задавать его отдельно. Используйте [SetsRequiredMembers], чтобы сообщить об этом компилятору.

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

Сочетание обязательных и необязательных членов

Обязательными являются только отмеченные Вами члены; остальные остаются необязательными и получают значения по умолчанию.

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 при наследовании

Обязательные члены наследуются. Производный класс может добавить собственные обязательные члены, и все они должны быть заданы.

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

Замена громоздких конструкторов

Сочетание required и init часто заменяет большие конструкторы: Вы получаете обязательные члены и понятный синтаксис инициализатора объекта.

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

Самодокументируемое назначение

Объявление членов обязательными показывает, какие значения необходимы, и упрощает правильное использование типа.

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

Собираем всё вместе

Тип, объединяющий обязательные, необязательные и проверяемые члены.

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

Быстрая проверка

Проверьте, что гарантирует модификатор required.

Итоги

Вы узнали о модификаторе required.

Он заставляет вызывающий код инициализировать член при создании объекта; это проверяет компилятор.
Он сочетается с init для создания обязательных неизменяемых членов.
[SetsRequiredMembers] позволяет конструктору выполнить это требование.
Обязательные члены наследуются.

Часто задаваемые вопросы

Урок «Модификатор required» бесплатный?

Да — полный текст урока «Модификатор required» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс C# Academy, подпишись на CoddyKit PRO. Курс C# Academy содержит 4 уроков всего.

Чему я научусь в уроке «Модификатор required»?

Требуйте от вызывающего кода задавать важные свойства. Ты практикуешь C# Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать C# Academy?

Предыдущий опыт не требуется. C# Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 2 из 4.

Сколько времени занимает урок «Модификатор required»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке C# Academy?

Да. Каждый урок C# Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

← Назад к C# Academy