.NET proqramlarında ən çox rast gəlinən çöküş mesajı budur: Object reference not set to an instance of an object. Dəyişəndə obyekt əvəzinə null var, kod isə onun metodunu çağırır. null istinadlarını 1965-ci ildə ALGOL W dilinə əlavə edən Toni Hoar sonralar onları «milyard dollarlıq səhvim» adlandırıb. C# 8-dən bəri kompilyator bu səhvlərin çoxunu proqram işə düşməmişdən əvvəl göstərə bilir — bunun üçün nullable istinad tipləri var. Siniflər və record-larla «Siniflər, xassələr, konstruktorlar və record-lar» dərsində tanış olmusan; indi onları null-a qarşı qoruyaq.
Null niyə proqramı çökdürür
string kimi istinad tipli dəyişən obyektin özünü yox, ona istinadı saxlayır. null «heç bir obyekt yoxdur» deməkdir. Belə dəyişəndə city.ToUpper() çağırmaq boş ünvana müraciətdir: işləmə zamanı NullReferenceException atılır. Aşağıdakı kodda #nullable disable köhnə, C# 8-dən əvvəlki davranışı qaytarır — kompilyator heç nə demir.
#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;Gözlənilən nəticə
Object reference not set to an instance of an object.
FindCity «Murad» üçün null qaytarır, amma onun tipi string-dir və bu barədə heç nə demir. Çağıran tərəf bunu bilə bilməz. Real proqramda try/catch olmazdı və istifadəçi çöküş görərdi — üstəlik bəlkə də aylar sonra, null nadir hallarda gələndə.
Davamını oxumaq üçün pulsuz qeydiyyatdan keç
Dərsin qalan bölmələri, test və qeydlər Educora hesabı ilə açılır. Qeydiyyat bir dəqiqə çəkir; irəliləyişin bütün cihazlarında saxlanılır.
Təhlükəsizlik toru: nullable kontekst
Nullable kontekstTərif
Kompilyatorun istinad tiplərini null baxımından yoxladığı rejim. Onda string «heç vaxt null deyil», string? isə «null ola bilər» deməkdir. Layihədə <Nullable>enable</Nullable> ilə, ayrıca faylda isə #nullable enable ilə qoşulur.
.NET 6-dan bəri dotnet new ilə yaradılan bütün layihələrdə bu rejim artıq qoşulub — .csproj faylına bax. İndi eyni səhvi kontekst qoşulmuş halda yazaq. FindCity artıq dürüstdür: string? qaytarır. Proqram yenə kompilyasiya olunur, amma kompilyator üç yerə barmaq basır:
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);Gözlənilən nəticə
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); xəbərdarlıqlara məhəl qoymadan işə salsan, proqram 2-ci sətirdə yenə NullReferenceException ilə çökür| Xəbərdarlıq | Mənası | Adi düzəliş |
|---|---|---|
CS8600 | null ola bilən qiymət null olmayan dəyişənə yazılır | dəyişəni string? et |
CS8602 | null ola bilən istinadın üzvünə müraciət | əvvəl yoxla (is null) və ya ?. |
CS8603 | null olmayan tip elan edən metod null qaytarır | qaytarılan tipi string? et |
CS8604 | null ola bilən arqument null olmayan parametrə ötürülür | arqumenti yoxla və ya parametri string? et |
CS8618 | konstruktor bitəndə null olmayan xassə hələ də boşdur | konstruktor, required və ya ilkin qiymət |
CS8625 | null literalı null olmayan yerə yazılır | tipi ? ilə işarələ |
Ən vacib fikir: bunlar xəbərdarlıqdır, xəta deyil. Kompilyator səni dayandırmır, sadəcə «burada null gələ bilər» deyir. Düzgün cavab — xəbərdarlığı susdurmaq yox, null halını həqiqətən emal etməkdir:
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;Gözlənilən nəticə
City unknown BAKU
null halı açıq emal olunubAxın analizi və null operatorları
Kompilyator hər dəyişənin vəziyyətini kod boyunca izləyir: «null ola bilər» və ya «null deyil». if (input is not null) daxilində, return-dən sonra və ya string.IsNullOrEmpty(input) yoxlamasından sonra o, dəyişənin artıq təhlükəsiz olduğunu bilir. Buna axın analizi deyilir. Aşağıdakı kodda xəbərdarlıq yalnız yoxlamadan əvvəlki sətirdədir:
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);Gözlənilən nəticə
Program.cs(2,19): warning CS8602: Dereference of a possibly null reference.
Hər null yoxlamasını if ilə yazmaq yorucudur, ona görə C#-da qısa operatorlar var. a?.B — a null deyilsə, B-ni oxu, əks halda bütün ifadə null-dır. x ?? y — x null deyilsə, x, əks halda y. x ??= y — x yalnız null olanda ona y-ni mənimsət. ?[] eyni işi indekslə görür: 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);Gözlənilən nəticə
no customer no email city unknown BAKU 17 True vip
?., ?? və ??= bir yerdəaysel.Address?.City.ToUpper() sətrinə diqqət et: ?. bütün zənciri «qısa qapayır» — ünvan null olsaydı, .City.ToUpper() heç hesablanmazdı, ona görə ikinci ?. lazım deyil. murad.Email?.Length int yox, int? qaytarır: nəticə null ola bilər. none?.Email?.Length is null True verir, çünki zəncir birinci addımda dayandı. tags ??= [] boş siyahı yaratdı, ikinci ??= isə heç nə etmədi — tags artıq null deyildi.
Konstruktorlar, required üzvlər və atributlar
null olmayan xassə obyekt yaradılanda mütləq doldurulmalıdır. Kompilyator konstruktor bitəndə hələ boş qalan belə xassə görsə, CS8618 verir:
var s = new Student { Name = "Leyla" };
Console.WriteLine(s.Name);
class Student
{
public string Name { get; set; }
public string? Nickname { get; set; }
}Gözlənilən nəticə
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 heç bir konstruktorda təyin olunmurDörd dürüst həll var: dəyəri konstruktorda tələb et; xassəni required et — onda obyekt başlatıcısında onu yazmamaq CS9035: Required member 'Student.Name' must be set in the object initializer or attribute constructor. xətasıdır; ağlabatan ilkin qiymət ver (= "Baku"); və ya xassə həqiqətən boş ola bilirsə, onu string? et.
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";
}Gözlənilən nəticə
Leyla, nickname: -, city: Baku
required, string? və ilkin qiymət: xəbərdarlıq yoxdurBəzən kompilyator kodun mənasını özü başa düşə bilmir. Tanış TryGetValue naxışını götür: metod true qaytaranda out parametri doludur, false qaytaranda — boş. Bunu kompilyatora atributlar izah edir. Aşağıda [NotNullWhen(true)] deyir: «nəticə true-dursa, student null deyil».
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);Gözlənilən nəticə
Leyla: 88 Elvin not found: True
s.Name sətrində xəbərdarlıq yoxdurAtributu silsən, proqram eyni nəticəni verir, amma qurma zamanı Program.cs(5,26): warning CS8602: Dereference of a possibly null reference. görünür: kompilyator TryFind-in nəticəsi ilə student-in vəziyyəti arasında əlaqəni bilmir. .NET-in özü də bu atributlardan geniş istifadə edir — string.IsNullOrEmpty [NotNullWhen(false)] ilə işarələnib, ona görə yuxarıdakı axın analizi işlədi.
| Atribut | Kompilyatora nə deyir |
|---|---|
[NotNullWhen(true)] | metod true qaytaranda bu out/parametr null deyil |
[MaybeNullWhen(false)] | metod false qaytaranda bu out qiyməti null ola bilər (Dictionary.TryGetValue) |
[NotNull] | çağırışdan sonra bu arqument null deyil (məsələn, ThrowIfNull-da) |
[AllowNull] | xassəyə null yazmaq olar, amma oxuyanda o heç vaxt null qaytarmır |
[MemberNotNull(nameof(_name))] | bu metod qayıdandan sonra _name sahəsi doludur |
Köhnə kodu köçürmək
Yüz minlərlə sətirlik köhnə layihədə nullable konteksti birdən qoşmaq yüzlərlə xəbərdarlıq verir. Bunu hissə-hissə etmək olar:
Fayl-fayl qoş
Layihədə
<Nullable>disable</Nullable>qalsın, köçürdüyün faylın əvvəlinə isə#nullable enableyaz. Xəbərdarlıqlar yalnız həmin faylda görünəcək.Kənardan başla
Əvvəlcə başqalarından asılı olmayan siniflər və public API: metodların imzaları bütün çağıran tərəflərə «
nullola bilər, ya yox» deyir.Hər istinad üçün qərar ver
Bu qiymət həqiqətən
nullola bilərmi? Bəli —?əlavə et vənullhalını emal et. Xeyr — onun həmişə doldurulduğunu konstruktorla və yarequiredilə təmin et.Toru bərkit
Hamısı köçürüləndə layihədə
<Nullable>enable</Nullable>və<WarningsAsErrors>nullable</WarningsAsErrors>yaz: bundan sonra yeni xəbərdarlıq qurmanı dayandırır.
<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 ilə yuxarıdakı CS8600, CS8602, CS8604 artıq xəbərdarlıq yox, xətadır və layihə qurulmurBir vacib həqiqəti unutma: nullable istinad tipləri yalnız kompilyasiya zamanı mövcuddur. string? işləmə zamanı adi string-dir, ! operatoru isə yalnız xəbərdarlığı susdurur — heç nəyi yoxlamır. int? başqa məsələdir: o, HasValue və Value xassələri olan həqiqi Nullable<int> strukturudur.
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);Gözlənilən nəticə
True True False 0 False Int32
null! xəbərdarlığı susdurdu, amma name yenə null-dırBuna görə public metodlarda işləmə zamanı yoxlamalarını saxla: sənin kitabxananı nullable konteksti söndürülmüş layihə çağıra və null ötürə bilər. ! yalnız kompilyatordan daha çox bildiyin nadir hallar üçündür — məsələn, dəyəri çərçivə (framework) sonradan özü doldurursa.
Mini layihə: təhlükəsiz ayarlar oxuyucusu
Proqramın ayarları lüğətdə saxlanır, bəzi açarlar yoxdur, bəzilərinin qiyməti null-dır. AppConfig sinfi dörd üsul təklif edir və hər birinin imzası null barədə dürüst danışır: Get — string?, GetInt — int?, Require — string (və ya istisna), 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;
}
}Gözlənilən nəticə
light 8080 30 Educora (7 letters) Setting 'Database' is missing
! yoxdurTheme açarı var, amma qiyməti null-dır — ?? light verdi. GetInt("Port") sətri ədədə çevirdi, Timeout isə yoxdur və int.TryParse(null, ...) sadəcə false qaytarır, ona görə susmaya görə 30 götürüldü. TryGet uğurlu olanda name.Length xəbərdarlıqsız işləyir. Require mütləq lazım olan ayar yoxdursa, dərhal aydın mesajla dayanır — null-ın proqramın dərinliklərində partlamasından qat-qat yaxşıdır.
Xülasə və tapşırıqlar
- Nullable kontekstdə
stringheç vaxtnullolmamalıdır,string?isə ola bilər; kompilyator fərqi xəbərdarlıqlarla izləyir. - Axın analizi
is null,returnvə atributlu metodlardan sonra dəyişənin təhlükəsiz olduğunu bilir. ?.zənciri qısa qapayır,??ehtiyat qiymət verir,??=yalnıznull-ı əvəz edir,!isə yalnız susdurur.- Köhnə kodu fayl-fayl köçür və sonda
WarningsAsErrorsilə toru bərkit.
Tapşırıq 1: e-poçt domenini təhlükəsiz tapmaq
Məsələ
Köhnə kodda class User { public string Name { get; set; } public string Email { get; set; } } və static string Domain(User user) => user.Email.Split('@')[1]; var. E-poçt məcburi deyil. Kodu elə dəyiş ki, xəbərdarlıq qalmasın, ad isə mütləq doldurulsun. Aysel (aysel@mail.az) və e-poçtu olmayan Murad üçün Domain(user) ?? "no email" nə çap edir?
Həllini göstərHəllini gizlət
Həll
public required string Name { get; init; }.2) E-poçt məcburi deyil:
public string? Email { get; init; }.3) Metod dürüst olmalıdır:
static string? Domain(User user) => user.Email?.Split('@')[1]; — e-poçt yoxdursa, ?. bütün zənciri dayandırır və null qaytarır.4) Nəticə:
mail.az və no email. new User() isə artıq CS9035 xətası verir.Tapşırıq 2: baş hərflər üçün `Try` metodu
Məsələ
bool TryGetInitials(string? fullName, out string? initials) metodunu yaz: ad boşdursa və ya yalnız boşluqlardan ibarətdirsə, false qaytarsın, əks halda hər sözün ilk hərfini birləşdirsin. Çağıran tərəf initials.Length-i xəbərdarlıqsız yaza bilməlidir. "Leyla Quliyeva", " " və null üçün nə çap olunur?
Həllini göstərHəllini gizlət
Həll
[NotNullWhen(true)] out string? initials (using System.Diagnostics.CodeAnalysis;).2) Əvvəlcə
initials = null;, sonra if (string.IsNullOrWhiteSpace(fullName)) return false; — bundan sonra kompilyator fullName-in null olmadığını bilir.3)
initials = ""; və foreach (string part in fullName.Split(' ', StringSplitOptions.RemoveEmptyEntries)) initials += part[0];, sonda return true;.4) Çağırış:
if (TryGetInitials(name, out string? initials)) Console.WriteLine($"{initials} ({initials.Length} letters)");, əks halda no initials.Nəticə:
LQ (2 letters), no initials, no initials.Yadda saxla
NullReferenceExceptionnullistinadın üzvünə müraciətdən yaranır; nullable kontekst onu kompilyasiya zamanı tutmağa kömək edir.<Nullable>enable</Nullable>(yeni layihələrdə susmaya görə) və ya#nullable enable;T—nulldeyil,T?—nullola bilər.- Xəbərdarlıqlar xəta deyil: onları
nullhalını emal edərək düzəlt,!ilə susdurma. ?.,??,??=və?? throwyoxlamaları qısaldır;?.nəticəsi qiymət tipləri üçünint?olur.CS8618-i konstruktor,requiredvə ya ilkin qiymətlə düzəlt;[NotNullWhen(true)]Trymetodlarını kompilyatora izah edir.- Annotasiyalar işləmə zamanı yoxdur: public metodlarda
ArgumentNullException.ThrowIfNullsaxla.