Безопасность null: ссылочные типы, допускающие null

Лови `NullReferenceException` до запуска программы: контекст nullable, `string` и `string?`, предупреждения компилятора и анализ потока, операторы `?.`, `??`, `??=` и `!`, `required` и `[NotNullWhen]`, перевод старого кода.

  • Средний
  • 21 мин
  • 12 вопросов
  • Урок 9 из 22

В этом уроке ты узнаешь

  • Включать контекст nullable и объяснять разницу между string и string?
  • Читать предупреждения CS8600, CS8602, CS8604 и CS8618 и правильно их устранять
  • Уместно использовать ?., ??, ??=, !, required и [NotNullWhen]
  • Пошагово переводить старый проект на безопасность null

Самое частое сообщение о сбое в программах на .NET: Object reference not set to an instance of an object. В переменной вместо объекта лежит null, а код вызывает у неё метод. Тони Хоар, добавивший null-ссылки в язык ALGOL W в 1965 году, позже назвал их своей «ошибкой на миллиард долларов». Начиная с C# 8 компилятор умеет указать на большинство таких ошибок ещё до запуска программы — для этого и существуют ссылочные типы, допускающие null. С классами и записями ты познакомился в уроке «Классы, свойства, конструкторы и записи»; теперь защитим их от null.

Почему null роняет программы

Переменная ссылочного типа, например string, хранит не сам объект, а ссылку на него. null означает «объекта нет». Вызов city.ToUpper() у такой переменной — обращение по пустому адресу, поэтому во время выполнения выбрасывается NullReferenceException. В коде ниже #nullable disable возвращает старое поведение, как до C# 8, — и компилятор молчит.

C#
#nullable disable
string city = FindCity("Murad");
try
{
    Console.WriteLine(city.ToUpper());
}
catch (NullReferenceException ex)
{
    Console.WriteLine(ex.Message);
}

static string FindCity(string name) => name == "Aysel" ? "Baku" : null;

Ожидаемый результат

Object reference not set to an instance of an object.
Компилятор молчит, ошибка проявляется только во время выполнения

FindCity возвращает null для «Murad», но её тип — string, и он ничего об этом не говорит. Вызывающий код никак не может об этом узнать. В настоящей программе не было бы try/catch, и пользователь увидел бы сбой — возможно, через несколько месяцев, когда редкий null наконец придёт.

Чтобы читать дальше, зарегистрируйся бесплатно

Остальные разделы урока, тест и заметки открываются с аккаунтом Educora. Регистрация занимает минуту, а прогресс сохраняется на всех твоих устройствах.

Страховочная сетка: контекст nullable

Контекст nullableОпределение

Режим, в котором компилятор проверяет ссылочные типы на null. В нём string означает «никогда не null», а string? — «может быть null». Для проекта он включается через <Nullable>enable</Nullable>, для отдельного файла — через #nullable enable.

Начиная с .NET 6 во всех проектах, созданных через dotnet new, этот режим уже включён — посмотри файл .csproj. Теперь напишем ту же ошибку при включённом контексте. FindCity теперь честен: он возвращает string?. Программа по-прежнему компилируется, но компилятор указывает на три места:

C#
string city = FindCity("Murad");
Console.WriteLine(city.ToUpper());
PrintLength(FindCity("Leyla"));

static string? FindCity(string name) => name == "Aysel" ? "Baku" : null;
static void PrintLength(string text) => Console.WriteLine(text.Length);

Ожидаемый результат

Program.cs(1,15): warning CS8600: Converting null literal or possible null value to non-nullable type.
Program.cs(2,19): warning CS8602: Dereference of a possibly null reference.
Program.cs(3,13): warning CS8604: Possible null reference argument for parameter 'text' in 'void PrintLength(string text)'.
Результат сборки (dotnet build); если всё равно запустить, программа падает на строке 2 с NullReferenceException
ПредупреждениеСмыслОбычное исправление
CS8600значение, которое может быть null, записывается в переменную без ?сделай переменную string?
CS8602обращение к члену ссылки, которая может быть nullсначала проверь (is null) или используй ?.
CS8603метод, объявленный без ?, возвращает nullсделай возвращаемый тип string?
CS8604аргумент, который может быть null, передаётся в параметр без ?проверь аргумент или сделай параметр string?
CS8618свойство без ? всё ещё пусто после конструктораконструктор, required или начальное значение
CS8625литерал null используется там, где null запрещёнпометь тип знаком ?

Главная мысль: это предупреждения, а не ошибки. Компилятор тебя не останавливает, он лишь говорит: «здесь может прийти null». Правильный ответ — не заглушить предупреждение, а действительно обработать случай null:

C#
string? city = FindCity("Murad");
if (city is null)
    Console.WriteLine("City unknown");
else
    Console.WriteLine(city.ToUpper());

Console.WriteLine(FindCity("Aysel")?.ToUpper());

static string? FindCity(string name) => name == "Aysel" ? "Baku" : null;

Ожидаемый результат

City unknown
BAKU
Версия без предупреждений: случай null обработан явно

Анализ потока и операторы для null

Компилятор отслеживает состояние каждой переменной по ходу кода: «может быть null» или «не null». Внутри if (input is not null), после return или после проверки string.IsNullOrEmpty(input) он знает, что переменная уже безопасна. Это называется анализом потока. В коде ниже предупреждение только в строке до всех проверок:

C#
string? input = args.Length > 0 ? args[0] : null;
Console.WriteLine(input.Length);

if (input is not null)
    Console.WriteLine(input.Length);

if (string.IsNullOrEmpty(input))
    return;
Console.WriteLine(input.Length);

Ожидаемый результат

Program.cs(2,19): warning CS8602: Dereference of a possibly null reference.
Результат сборки: строки 5 и 9 считаются безопасными

Писать каждую проверку на null через if утомительно, поэтому в C# есть короткие операторы. a?.B — если a не null, прочитай B, иначе всё выражение равно null. x ?? y — x, если он не null, иначе y. x ??= y — присвоить y переменной x, только если x равен null. ?[] делает то же с индексом: list?[0].

C#
Customer? none = null;
Customer aysel = new("Aysel", null, new Address("Baku", "AZ1000"));
Customer murad = new("Murad", "murad@example.com", null);

Console.WriteLine(none?.Name ?? "no customer");
Console.WriteLine(aysel.Email ?? "no email");
Console.WriteLine(murad.Address?.City ?? "city unknown");
Console.WriteLine(aysel.Address?.City.ToUpper());

int? length = murad.Email?.Length;
Console.WriteLine(length);
Console.WriteLine(none?.Email?.Length is null);

List<string>? tags = null;
tags ??= [];
tags.Add("vip");
tags ??= ["never used"];
Console.WriteLine(string.Join(", ", tags));

record Address(string City, string PostalCode);
record Customer(string Name, string? Email, Address? Address);

Ожидаемый результат

no customer
no email
city unknown
BAKU
17
True
vip
?., ?? и ??= вместе

Обрати внимание на aysel.Address?.City.ToUpper(): ?. «замыкает накоротко» всю цепочку — если бы адрес был null, .City.ToUpper() вообще не вычислялся бы, поэтому второй ?. не нужен. murad.Email?.Length возвращает не int, а int?: результат может быть null. none?.Email?.Length is null даёт True, потому что цепочка остановилась на первом шаге. tags ??= [] создал пустой список, а второй ??= ничего не сделал — tags уже не был null.

Конструкторы, обязательные члены и атрибуты

Свойство без ? обязательно должно быть заполнено при создании объекта. Если компилятор видит, что после конструктора такое свойство всё ещё пусто, он выдаёт CS8618:

C#
var s = new Student { Name = "Leyla" };
Console.WriteLine(s.Name);

class Student
{
    public string Name { get; set; }
    public string? Nickname { get; set; }
}

Ожидаемый результат

Program.cs(6,19): warning CS8618: Non-nullable property 'Name' must contain a non-null value when exiting constructor. Consider adding the 'required' modifier or declaring the property as nullable.
Результат сборки: Name не задаётся ни в одном конструкторе

Есть четыре честных решения: требовать значение в конструкторе; сделать свойство required — тогда пропуск его в инициализаторе объекта даёт ошибку CS9035: Required member 'Student.Name' must be set in the object initializer or attribute constructor.; дать разумное начальное значение (= "Baku"); или, если свойство действительно может быть пустым, сделать его string?.

C#
var s = new Student { Name = "Leyla" };
Console.WriteLine($"{s.Name}, nickname: {s.Nickname ?? "-"}, city: {s.City}");

class Student
{
    public required string Name { get; init; }
    public string? Nickname { get; set; }
    public string City { get; set; } = "Baku";
}

Ожидаемый результат

Leyla, nickname: -, city: Baku
required, string? и начальное значение: предупреждений нет

Иногда компилятор не может сам понять смысл кода. Возьмём знакомый шаблон TryGetValue: когда метод возвращает true, параметр out заполнен, а когда false — пуст. Объяснить это компилятору помогают атрибуты. Ниже [NotNullWhen(true)] говорит: «если результат true, то student не null».

C#
using System.Diagnostics.CodeAnalysis;

var repo = new StudentRepository();
if (repo.TryFind("Leyla", out Student? s))
    Console.WriteLine($"{s.Name}: {s.Score}");
if (!repo.TryFind("Elvin", out Student? missing))
    Console.WriteLine($"Elvin not found: {missing is null}");

class StudentRepository
{
    private readonly Dictionary<string, Student> _students = new()
    {
        ["Leyla"] = new Student("Leyla", 88)
    };

    public bool TryFind(string name, [NotNullWhen(true)] out Student? student) =>
        _students.TryGetValue(name, out student);
}

record Student(string Name, int Score);

Ожидаемый результат

Leyla: 88
Elvin not found: True
Благодаря атрибуту на s.Name нет предупреждения

Если убрать атрибут, программа выведет то же самое, но при сборке появится Program.cs(5,26): warning CS8602: Dereference of a possibly null reference.: компилятор не знает связи между результатом TryFind и состоянием student. Сам .NET широко использует эти атрибуты — string.IsNullOrEmpty помечен [NotNullWhen(false)], поэтому анализ потока выше и сработал.

АтрибутЧто сообщает компилятору
[NotNullWhen(true)]когда метод возвращает true, этот параметр out или аргумент не null
[MaybeNullWhen(false)]когда метод возвращает false, это значение out может быть null (Dictionary.TryGetValue)
[NotNull]после вызова этот аргумент не null (например, в ThrowIfNull)
[AllowNull]свойству можно присвоить null, но при чтении оно никогда не вернёт null
[MemberNotNull(nameof(_name))]после возврата из этого метода поле _name заполнено

Перевод старого кода

Если сразу включить контекст nullable в старом проекте на сотни тысяч строк, появятся сотни предупреждений. Это можно делать по частям:

  1. Включай по файлам

    Оставь в проекте <Nullable>disable</Nullable>, а в начале переводимого файла напиши #nullable enable. Предупреждения появятся только в этом файле.

  2. Начни с краёв

    Сначала классы, которые ни от чего не зависят, и публичный API: сигнатуры методов сообщают всем вызывающим, возможен null или нет.

  3. Реши для каждой ссылки

    Может ли это значение действительно быть null? Да — добавь ? и обработай случай null. Нет — гарантируй заполнение конструктором или required.

  4. Затяни сетку

    Когда всё переведено, задай в проекте <Nullable>enable</Nullable> и <WarningsAsErrors>nullable</WarningsAsErrors>: с этого момента любое новое предупреждение останавливает сборку.

XML
<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net10.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <WarningsAsErrors>nullable</WarningsAsErrors>
  </PropertyGroup>

</Project>
С WarningsAsErrors показанные выше CS8600, CS8602 и CS8604 становятся ошибками, и проект не собирается

Не забывай одну важную истину: ссылочные типы, допускающие null, существуют только во время компиляции. Во время выполнения string? — обычный string, а оператор ! лишь заглушает предупреждение и ничего не проверяет. С int? всё иначе: это настоящая структура Nullable<int> со свойствами HasValue и Value.

C#
string name = null!;
Console.WriteLine(name is null);

string? maybe = "text";
Console.WriteLine(maybe.GetType() == typeof(string));

int? number = null;
Console.WriteLine(number.HasValue);
Console.WriteLine(number.GetValueOrDefault());
Console.WriteLine(typeof(int?) == typeof(int));
Console.WriteLine(Nullable.GetUnderlyingType(typeof(int?))?.Name);

Ожидаемый результат

True
True
False
0
False
Int32
null! заглушил предупреждение, но name по-прежнему null

Поэтому в публичных методах сохраняй проверки во время выполнения: твою библиотеку может вызвать проект с выключенным контекстом nullable и передать null. ! нужен лишь в редких случаях, когда ты знаешь больше компилятора, — например, когда значение позже заполняет сам фреймворк.

Мини-проект: безопасное чтение настроек

Программа хранит настройки в словаре; некоторых ключей нет, а у некоторых значение null. Класс AppConfig предлагает четыре метода, и сигнатура каждого честно говорит о null: Get возвращает string?, GetInt — int?, Require — string (или исключение), а TryGet использует [NotNullWhen(true)].

C#
using System.Diagnostics.CodeAnalysis;

var settings = new Dictionary<string, string?>
{
    ["AppName"] = "Educora", ["Port"] = "8080", ["Theme"] = null
};
var config = new AppConfig(settings);

Console.WriteLine(config.Get("Theme") ?? "light");
Console.WriteLine(config.GetInt("Port") ?? 80);
Console.WriteLine(config.GetInt("Timeout") ?? 30);
if (config.TryGet("AppName", out string? name))
    Console.WriteLine($"{name} ({name.Length} letters)");
try { config.Require("Database"); }
catch (InvalidOperationException ex) { Console.WriteLine(ex.Message); }

class AppConfig(Dictionary<string, string?> values)
{
    public string? Get(string key) => values.GetValueOrDefault(key);
    public int? GetInt(string key) => int.TryParse(Get(key), out int n) ? n : null;
    public string Require(string key) =>
        Get(key) ?? throw new InvalidOperationException($"Setting '{key}' is missing");

    public bool TryGet(string key, [NotNullWhen(true)] out string? value)
    {
        value = Get(key);
        return value is not null;
    }
}

Ожидаемый результат

light
8080
30
Educora (7 letters)
Setting 'Database' is missing
Ни одного предупреждения и ни одного !

Ключ Theme есть, но его значение null, поэтому ?? дал light. GetInt("Port") превратил строку в число, а Timeout отсутствует, и int.TryParse(null, ...) просто возвращает false, поэтому взято значение по умолчанию 30. Когда TryGet успешен, name.Length работает без предупреждения. Require сразу останавливается с понятным сообщением, если обязательной настройки нет, — это гораздо лучше, чем null, взрывающийся где-то в глубине программы.

Итоги и задания

  • В контексте nullable string никогда не должен быть null, а string? может; компилятор следит за разницей с помощью предупреждений.
  • Анализ потока знает, что переменная безопасна после is null, return и методов с атрибутами.
  • ?. замыкает цепочку накоротко, ?? даёт запасное значение, ??= заменяет только null, а ! лишь заглушает.
  • Переводи старый код по файлам и в конце затяни сетку через WarningsAsErrors.

Задание 1: безопасно найти домен почты

Задача

В старом коде есть class User { public string Name { get; set; } public string Email { get; set; } } и static string Domain(User user) => user.Email.Split('@')[1];. Почта необязательна. Измени код так, чтобы не осталось предупреждений, а имя всегда было заполнено. Что напечатает Domain(user) ?? "no email" для Aysel (aysel@mail.az) и для Murad без почты?

Показать решениеСкрыть решение

Решение

1) Имя обязательно: public required string Name { get; init; }.
2) Почта необязательна: public string? Email { get; init; }.
3) Метод должен быть честным: static string? Domain(User user) => user.Email?.Split('@')[1]; — если почты нет, ?. останавливает всю цепочку и возвращает null.
4) Вывод: mail.az и no email. А new User() теперь даёт ошибку CS9035.

Задание 2: метод `Try` для инициалов

Задача

Напиши метод bool TryGetInitials(string? fullName, out string? initials): он возвращает false, если имя null, пустое или из одних пробелов, а иначе склеивает первые буквы всех слов. Вызывающий код должен писать initials.Length без предупреждения. Что будет напечатано для "Leyla Quliyeva", " " и null?

Показать решениеСкрыть решение

Решение

1) Добавь атрибут к параметру: [NotNullWhen(true)] out string? initials (using System.Diagnostics.CodeAnalysis;).
2) Сначала initials = null;, затем if (string.IsNullOrWhiteSpace(fullName)) return false; — после этого компилятор знает, что fullName не null.
3) initials = ""; и foreach (string part in fullName.Split(' ', StringSplitOptions.RemoveEmptyEntries)) initials += part[0];, в конце return true;.
4) Вызов: if (TryGetInitials(name, out string? initials)) Console.WriteLine($"{initials} ({initials.Length} letters)");, иначе no initials.
Вывод: LQ (2 letters), no initials, no initials.

Запомни

  • NullReferenceException возникает при обращении к члену null-ссылки; контекст nullable помогает поймать его при компиляции.
  • <Nullable>enable</Nullable> (по умолчанию в новых проектах) или #nullable enable; T — не null, T? — может быть null.
  • Предупреждения — не ошибки: исправляй их, обрабатывая случай null, а не заглушая через !.
  • ?., ??, ??= и ?? throw сокращают проверки; результат ?. для значимых типов — int?.
  • Исправляй CS8618 конструктором, required или начальным значением; [NotNullWhen(true)] объясняет компилятору методы Try.
  • Аннотаций во время выполнения нет: сохраняй ArgumentNullException.ThrowIfNull в публичных методах.
Заметил ошибку или неточность в уроке?

Проверь себя

Вопросов: 12. Каждый правильный ответ приносит XP.

Вопрос 1 / 12

Вопрос 1 / 12. Что означает объявление string? email при включённом контексте nullable?