CKTIS / C#
Array.Empty<T> — een lege array van een bepaald type
Array.Empty<T>() retourneert een niet-null array van het type T[] met lengte nul. Gebruik deze methode om aan te geven dat er geen elementen zijn, zonder bij elke aanroep een nieuwe lege array te maken.
Versie: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Array.Empty<T>()Array.Empty<T> is een statische methode van System.Array, beschikbaar in .NET 10. De declaratie is public static T[] Empty<T>();. De typeparameter T bepaalt het elementtype; Array.Empty<string>() retourneert bijvoorbeeld een lege string[]. De methode heeft geen argumenten.
Het resultaat is niet null: de Length is 0 en een foreach-lus voert geen iteraties uit. Zo kun je „geen elementen” aangeven zonder vóór het itereren op null te controleren. Een lege array heeft echter geen element op index 0 — lees die index niet uit en schrijf er niet naar.
Gebruik Array.Empty<T>() in plaats van new T[0] wanneer je een lege array nodig hebt. Voor een bepaalde T gebruikt de methode een gedeelde lege instantie, zodat herhaalde toewijzingen van lege arrays worden vermeden. Zie dit niet als een manier om bij elke aanroep een afzonderlijk object te maken; analyzerregel CA1825 beveelt deze vervanging aan.
Het voorbeeld drukt de lengte van de array af en het resultaat van een null-controle. De lus drukt niets af. Dit is een .NET-bibliotheek-API, geen syntaxisfunctie waarvoor LangVersion=preview nodig is.
Voorbeelden
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);
}
}
}Resultaat
0 False
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.