Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C#

`#nullable enable` et l’annotation `T?` pour les types référence

Activez les annotations de nullabilité des types référence et les avertissements du compilateur. Voyez comment un test de `null` influe sur l’analyse du flux et pourquoi `string?` diffère de `int?`.

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

Syntaxe

#nullable enable
// T? denotes a nullable reference when T is a reference type.
static void ShowLength(string? text)
{
    if (text is not null)
        System.Console.WriteLine(text.Length);
}
#nullable restore

#nullable enable active à la fois les annotations de nullabilité et les avertissements associés. La directive s’applique à partir de cet endroit dans le fichier source, jusqu’à ce qu’une autre directive modifie ces réglages ou que le fichier se termine. #nullable restore rétablit les réglages du projet, et non les réglages précédents dans le fichier.

Si T est un type référence, T? indique que null est autorisé, tandis que T indique qu’une référence non nulle est attendue. string et string? correspondent au même type à l’exécution et ne permettent pas de distinguer deux surcharges. Le compilateur n’ajoute aucun test automatique : accéder à un membre via une référence nulle peut toujours lever une NullReferenceException.

L’analyse du flux détermine à quels endroits une référence peut être nulle. Un accès à text.Length avant le test déclencherait CS8602. Avec text is null et le return anticipé, l’accès qui suit n’est atteint que si text n’est pas null. Écrire text! peut supprimer l’avertissement, mais ne teste ni ne modifie la valeur.

À l’inverse, int? est la forme abrégée de System.Nullable<int>, un type valeur distinct qui peut aussi représenter l’absence de valeur. string? n’encapsule pas la référence dans System.Nullable<T>.

Exemples

#nullable enable
using System;

PrintLength(null);
PrintLength("Ada");

static void PrintLength(string? text)
{
    // Console.WriteLine(text.Length); // CS8602
    if (text is null)
    {
        Console.WriteLine("No text");
        return;
    }

    Console.WriteLine(text.Length);
}

Résultat

No text
3

Le premier appel affiche `No text` et se termine avant de lire `Length`. Le second affiche `3`. Pour voir `CS8602`, décommentez le premier accès à `text.Length` dans `PrintLength`, puis compilez sans exécuter le programme.

Leçons associées

  • C# · Leçon 17 · Intermédiaire · Version : 2

Sources