C# Academy · Les

NRT inschakelen en begrijpen

Schakel de nullable-context in, krijg inzicht in nullable en non-nullable referentietypen en lees compilerwaarschuwingen.

Les 1 van 413 stappen

NRT inschakelen en begrijpen is een gratis C# Academy-les op CoddyKit. Dit is les 1 van 4. Je kunt de volledige les hieronder gratis lezen en daarna in de browser praktisch oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is. Deze les maakt deel uit van het leertraject C# Academy. Je voortgang wordt gesynchroniseerd op het web en in de CoddyKit-app. De cursus C# Academy bevat in totaal 4 lessen.

De fout van een miljard dollar

Tony Hoare (de uitvinder van null) noemde het zijn 'fout van een miljard dollar'. In C# kon elk referentietype standaard null zijn, waardoor NullReferenceException de meest voorkomende crash tijdens de uitvoering werd. Nullable referentietypen (NRT) lossen dit op tijdens het compileren.

De nullable-context inschakelen

Schakel NRT globaal in je projectbestand in of per bestand met instructies. Zodra dit is ingeschakeld, behandelt de compiler referentietypen standaard als niet-nullable.

<!-- In .csproj — enable for the whole project -->
<PropertyGroup>
  <Nullable>enable</Nullable>
</PropertyGroup>

// Or per-file:
#nullable enable
// ... code with NRT warnings
#nullable disable
// ... code without NRT warnings

Niet-nullable versus nullable referentietypen

Met ingeschakelde NRT betekent string dat de waarde nooit null is en betekent string? dat deze mogelijk null is. De compiler geeft een waarschuwing als je null toewijst aan een niet-nullable type of een nullable waarde gebruikt zonder controle.

#nullable enable

string nonNull = "Hello";    // OK
string? maybeNull = null;    // OK — explicitly nullable

nonNull = null;              // WARNING: CS8600
Console.WriteLine(maybeNull.Length); // WARNING: CS8602 — may be null

// Fix:
if (maybeNull is not null)
    Console.WriteLine(maybeNull.Length); // safe

Stroomanalyse

De compiler voert stroomanalyse uit — hij houdt de nullstatus bij via voorwaarden en vertakkingen en onderdrukt waarschuwingen wanneer hij kan bewijzen dat een waarde niet null is.

string? name = GetName();

// After null check, name is treated as non-null:
if (name is not null)
    Console.WriteLine(name.Length);  // no warning

// Same with early return:
if (name is null) return;
Console.WriteLine(name.Length);     // no warning — null was returned

// Pattern matching:
if (name is string s)
    Console.WriteLine(s.ToUpper()); // no warning

Nullable-waarschuwingen: CS8600–CS8629

Belangrijke NRT-waarschuwingen die je moet begrijpen: CS8600 (null toewijzen aan een niet-nullable type), CS8602 (een mogelijk-null waarde gebruiken), CS8603 (null retourneren voor een niet-nullable type), CS8618 (niet-geïnitialiseerd niet-nullable veld).

#nullable enable

public class Order
{
    public string CustomerName { get; set; } // CS8618: not initialized
    public string? TrackingNumber { get; set; } // OK — nullable

    public Order(string name)
    {
        CustomerName = name; // now initialized — CS8618 gone
    }
}

string? s = GetValue();
Console.WriteLine(s.Length); // CS8602: s might be null

Niet-nullable velden initialiseren

CS8618 treedt op wanneer een niet-nullable veld of een niet-nullable eigenschap niet in de constructor wordt ingesteld. Oplossingen: initialiseer deze in de declaratie, verplicht de waarde via de constructor of gebruik de null-onderdrukkingsoperator voor DI/ORM-patronen.

// Option 1: Initialize in declaration
public string Name { get; set; } = "";

// Option 2: Require via constructor
public class Product
{
    public string Name { get; }
    public Product(string name) => Name = name;
}

// Option 3: null-forgiving for ORM entities
public string Name { get; set; } = null!;
// null! tells compiler "trust me, this will be set by EF Core"

Nullable in generieke typen

Generieke typeparameters kunnen worden beperkt tot niet-nullable waarden. Een beperking where T : notnull zorgt ervoor dat T nooit null kan zijn.

// Without constraint: T could be nullable
public T? Find<T>(int id) { ... }

// With notnull: T must be a non-nullable type
public T FindRequired<T>(int id) where T : notnull
{
    var result = InternalFind<T>(id);
    return result ?? throw new KeyNotFoundException();
}

// T? is meaningful only when T is known to be non-nullable
public T? FindOrDefault<T>(int id) where T : class { ... }

Nullable in interfaces en overschrijvingen

Bij het implementeren van een interface of het overschrijven van een methode moeten nullbaarheidsannotaties overeenkomen. De compiler controleert of implementaties minstens zo niet-nullable zijn als de interface voorschrijft.

public interface IRepository<T>
{
    T? FindById(int id);       // may return null
    T GetOrThrow(int id);      // never null
}

// Implementation:
public class ProductRepo : IRepository<Product>
{
    public Product? FindById(int id)  => _db.Find(id);
    public Product  GetOrThrow(int id) =>
        _db.Find(id) ?? throw new KeyNotFoundException();
}

Nullable waardetypen versus nullable referentietypen

Verwar int? (Nullable<int> — een omhulling voor een waardetype die al vóór C# 8 bestond) niet met string? (een NRT-annotatie — alleen tijdens het compileren, zonder extra kosten tijdens de uitvoering).

// Nullable value type (runtime Nullable<int>)
int? age = null;
bool hasValue = age.HasValue;
int value  = age.GetValueOrDefault();

// Nullable reference type (compile-time annotation only)
string? name = null;
// string? has NO runtime wrapper — it's just a compile-time hint
// null check is still needed at runtime
if (name is not null)
    Console.WriteLine(name.ToUpper());

Waarschuwingen onderdrukken met !

De null-onderdrukkingsoperator (!) onderdrukt een specifieke nullable-waarschuwing wanneer je zeker weet dat de compiler het bij het verkeerde eind heeft. Gebruik deze spaarzaam en leg vast waarom dit veilig is.

// Use ! when you know the value cannot be null
var user = _db.Users.FirstOrDefault(u => u.Email == email);
var name = user!.Name; // user is guaranteed by business logic

// EF Core navigation properties set by the framework:
public class Order
{
    public Customer Customer { get; set; } = null!; // set by EF Core
}

Uit de praktijk: nullable API-respons

Een API-omhulling waarvan velden al dan niet aanwezig kunnen zijn in de JSON-respons — nullable annotaties maken de bedoeling duidelijk.

#nullable enable

public class WeatherResponse
{
    public string City { get; set; } = "";     // always present
    public double Temperature { get; set; }     // always present
    public string? Description { get; set; }    // optional field
    public string? AlertMessage { get; set; }   // only when there's an alert
}

// Consumer:
var weather = await api.GetWeatherAsync("London");
Console.WriteLine(weather.City);            // safe
Console.WriteLine(weather.Description?.ToUpper() ?? "N/A"); // safe null-handling

Korte controle

Wat zijn de extra kosten tijdens de uitvoering van Nullable Reference Types (string?) vergeleken met gewone referentietypen (string)?

Samenvatting: NRT inschakelen en begrijpen

Belangrijkste punten:

  • Schakel NRT globaal in met <Nullable>enable</Nullable> in .csproj
  • string = nooit null; string? = mogelijk null
  • Stroomanalyse houdt de nullstatus bij via vertakkingen en retourwaarden
  • NRT-annotaties gelden alleen tijdens het compileren — geen extra kosten tijdens de uitvoering
  • CS8618: initialiseer niet-nullable velden in de constructor of gebruik = null! voor ORM
  • Gebruik ! spaarzaam — leg vast waarom de null-onderdrukking veilig is
Gratis beginnen

Leer C# met een AI-tutor — gratis

Schrijf echte code en voer die uit in je browser, krijg direct hulp van een AI-tutor die 24/7 beschikbaar is en ga verder waar je gebleven bent op het web of in de app.

Cursussen
93
Lessen
346

Veelgestelde vragen

Is de les “NRT inschakelen en begrijpen” gratis?

Ja — de volledige tekst van “NRT inschakelen en begrijpen” kun je hier gratis op het web lezen. Als je interactief wilt oefenen met een ingebouwde code-editor en een AI-begeleider die 24/7 beschikbaar is, en de rest van de cursus C# Academy wilt ontgrendelen, kun je upgraden naar CoddyKit PRO. De cursus C# Academy bevat in totaal 4 lessen.

Wat leer ik in “NRT inschakelen en begrijpen”?

Schakel de nullable-context in, krijg inzicht in nullable en non-nullable referentietypen en lees compilerwaarschuwingen. Je oefent met C# Academy door code rechtstreeks in de browser uit te voeren. Een AI-begeleider die 24/7 beschikbaar is beantwoordt je vragen terwijl je de les doorwerkt.

Heb ik ervaring nodig om met C# Academy te beginnen?

Ervaring vooraf is niet nodig. C# Academy op CoddyKit is opgebouwd voor beginners tot gevorderden, zodat je hier of bij het begin kunt starten en in je eigen tempo kunt leren. Dit is les 1 van 4.

Hoe lang duurt de les “NRT inschakelen en begrijpen”?

De meeste lessen van CoddyKit duren ongeveer 5–10 minuten. Elke les is kort en interactief, zodat je gestaag vooruitgaat en op het web en in de app precies verdergaat waar je was gebleven.

Kan ik code schrijven en uitvoeren in deze les over C# Academy?

Ja. Elke les over C# Academy bevat een ingebouwde code-editor, zodat je rechtstreeks in je browser echte code kunt schrijven en uitvoeren en direct feedback van AI krijgt — lokale installatie is niet nodig.

Alle lessen in deze cursus

  1. NRT inschakelen en begrijpen
  2. Annotaties: ?, !, MaybeNull en NotNull
  3. Null-conditional- en null-coalescing-operators
  4. Een codebase migreren naar NRT
← Terug naar C# Academy