Baza znanjaCentar za ispite
HRHrvatski
Odaberi jezik13

CKTIS / C#

C# — `#nullable enable`, `string?` i `[NotNullWhen(true)]` za dva parametra `out`

Uključi analizu vrijednosti `null` i opiši oba izlaza metode `Try*` kako bi prevoditelj znao da pri uspjehu nijedan nije `null`.

Verzija: C# 12 and .NET 8; later runtimes may add compatible features

Sintaksa

#nullable enable
using System.Diagnostics.CodeAnalysis;

static bool TryGetLabels(
    string key,
    [NotNullWhen(true)] out string? primary,
    [NotNullWhen(true)] out string? secondary)

U C#-u 12 na .NET-u 8 direktiva #nullable enable uključuje oznake mogućnosti vrijednosti null i povezana upozorenja za sljedeće retke, sve dok druga direktiva ne promijeni kontekst ili do kraja datoteke. string? dopušta null; string deklarira referencu koja ne bi trebala biti null. Tip je tijekom izvođenja isti, a oznaka ne dodaje provjeru tijekom izvođenja.

[NotNullWhen(true)] skraćeni je zapis atributa NotNullWhenAttribute iz imenskog prostora System.Diagnostics.CodeAnalysis. Na parametru out string? znači da, ako metoda vrati true, upravo taj izlaz nije null. Jamstvo vrijedi samo za označeni parametar, pa TryGetLabels zasebno označava primary i secondary.

Metoda mora dodijeliti vrijednosti obama parametrima out prije svakog redovitog povratka. Za "menu" ova implementacija daje "Open" i "Close" te vraća true. Za drugi ključ dodjeljuje null obama parametrima i vraća false. To je odluka implementacije: atribut ne zahtijeva da bilo koji izlaz bude null kada metoda vrati false.

U grani if prevoditelj obje reference smatra različitima od null, pa možeš pročitati oba svojstva Length bez !. U grani else obje vrijednosti smatra potencijalno jednakima null; ?? daje zamjenski tekst. Atribut ne provodi ugovor tijekom izvođenja. Za usporedbu, [MaybeNull] dopušta da izlaz bude null unatoč deklaraciji koja to ne dopušta, dok [MemberNotNull] opisuje stanje navedenih polja ili svojstava nakon povratka iz metode, a ne stanje parametara out.

Primjeri

#nullable enable
using System;
using System.Diagnostics.CodeAnalysis;

foreach (string key in new[] { "menu", "other" })
{
    if (TryGetLabels(key, out string? primary, out string? secondary))
    {
        Console.WriteLine($"{primary.Length}, {secondary.Length}");
    }
    else
    {
        Console.WriteLine($"{primary ?? "<null>"}, {secondary ?? "<null>"}");
    }
}

static bool TryGetLabels(
    string key,
    [NotNullWhen(true)] out string? primary,
    [NotNullWhen(true)] out string? secondary)
{
    if (key == "menu")
    {
        primary = "Open";
        secondary = "Close";
        return true;
    }

    primary = null;
    secondary = null;
    return false;
}

Rezultat

4, 5
<null>, <null>

Prvi redak sadrži duljine obiju oznaka, a drugi prikazuje oba pokazatelja za `null`. Ukloni atribut samo s parametra `secondary` i ponovno prevedi: očekuje se CS8602 na `secondary.Length`, ali ne na `primary.Length`.

Povezane lekcije

  • C# · Lekcija 53 · Napredno · Verzija: 3

Izvori