Самое частое сообщение о сбое в программах на .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, — и компилятор молчит.
#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?. Программа по-прежнему компилируется, но компилятор указывает на три места:
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:
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) он знает, что переменная уже безопасна. Это называется анализом потока. В коде ниже предупреждение только в строке до всех проверок:
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.
Писать каждую проверку на null через if утомительно, поэтому в C# есть короткие операторы. a?.B — если a не null, прочитай B, иначе всё выражение равно null. x ?? y — x, если он не null, иначе y. x ??= y — присвоить y переменной x, только если x равен null. ?[] делает то же с индексом: list?[0].
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:
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?.
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».
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 в старом проекте на сотни тысяч строк, появятся сотни предупреждений. Это можно делать по частям:
Включай по файлам
Оставь в проекте
<Nullable>disable</Nullable>, а в начале переводимого файла напиши#nullable enable. Предупреждения появятся только в этом файле.Начни с краёв
Сначала классы, которые ни от чего не зависят, и публичный API: сигнатуры методов сообщают всем вызывающим, возможен
nullили нет.Реши для каждой ссылки
Может ли это значение действительно быть
null? Да — добавь?и обработай случайnull. Нет — гарантируй заполнение конструктором илиrequired.Затяни сетку
Когда всё переведено, задай в проекте
<Nullable>enable</Nullable>и<WarningsAsErrors>nullable</WarningsAsErrors>: с этого момента любое новое предупреждение останавливает сборку.
<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.
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)].
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 без почты?
Показать решениеСкрыть решение
Решение
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?
Показать решениеСкрыть решение
Решение
[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в публичных методах.