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

CKTIS / C#

Array.Empty<T> — un tableau vide d’un type donné

Array.Empty<T>() renvoie un tableau non null de type T[] dont la longueur est nulle. Utilisez cette méthode pour représenter l’absence d’éléments sans créer un nouveau tableau vide à chaque appel.

Version : .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification

Syntaxe

Array.Empty<T>()

Array.Empty<T> est une méthode statique de System.Array, disponible dans .NET 10. Sa déclaration est public static T[] Empty<T>();. Le paramètre de type T indique le type des éléments ; par exemple, Array.Empty<string>() renvoie un tableau string[] vide. La méthode ne prend aucun argument.

Le résultat n’est pas null : sa propriété Length vaut 0 et une boucle foreach n’effectue aucune itération. Vous pouvez ainsi représenter « aucun élément » sans vérifier si la valeur est null avant de parcourir le tableau. Toutefois, un tableau vide ne contient aucun élément à l’indice 0 — ne lisez pas et n’écrivez pas à cet indice.

Utilisez Array.Empty<T>() plutôt que new T[0] lorsque vous avez besoin d’un tableau vide. Pour un T donné, la méthode utilise une instance vide partagée et évite les allocations répétées de tableaux vides. Ne la considérez pas comme un moyen de créer un objet distinct à chaque appel ; la règle d’analyseur CA1825 recommande ce remplacement.

L’exemple affiche la longueur du tableau et le résultat d’une vérification de null. La boucle n’affiche rien. Il s’agit d’une API de la bibliothèque .NET, et non d’une fonctionnalité de syntaxe nécessitant LangVersion=preview.

Exemples

using System;

internal static class Program
{
    private static void Main()
    {
        string[] names = Array.Empty<string>();
        Console.WriteLine(names.Length);
        Console.WriteLine(names is null);

        foreach (string name in names)
        {
            Console.WriteLine(name);
        }
    }
}

Résultat

0
False

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources