CKTIS / C#
Array.Empty<T> — ein leeres Array eines bestimmten Typs
Array.Empty<T>() gibt ein nicht-null Array vom Typ T[] mit der Länge null zurück. Verwende die Methode, um keine Elemente darzustellen, ohne bei jedem Aufruf ein neues leeres Array zu erstellen.
Version: .NET 10; repository net10.0 and LangVersion=preview; feature versions require per-entry verification
Syntax
Array.Empty<T>()Array.Empty<T> ist eine statische Methode von System.Array, verfügbar in .NET 10. Ihre Deklaration lautet public static T[] Empty<T>();. Der Typparameter T legt den Elementtyp fest; zum Beispiel gibt Array.Empty<string>() ein leeres string[] zurück. Die Methode nimmt keine Argumente entgegen.
Das Ergebnis ist nicht null: Seine Length beträgt 0, und eine foreach-Schleife führt keine Iterationen aus. So kannst du „keine Elemente“ darstellen, ohne vor der Iteration auf null prüfen zu müssen. Ein leeres Array hat jedoch kein Element am Index 0 — lies diesen Index nicht aus und schreibe nicht darauf.
Verwende Array.Empty<T>() statt new T[0], wenn du ein leeres Array benötigst. Die Methode verwendet für ein bestimmtes T eine gemeinsam genutzte leere Instanz und vermeidet so wiederholte Zuweisungen leerer Arrays. Betrachte sie nicht als Möglichkeit, bei jedem Aufruf ein eigenes Objekt zu erstellen; die Analyzerregel CA1825 empfiehlt diesen Ersatz.
Das Beispiel gibt die Länge des Arrays und das Ergebnis einer null-Prüfung aus. Die Schleife gibt nichts aus. Dies ist eine .NET-Bibliotheks-API und kein Syntaxmerkmal, für das LangVersion=preview erforderlich ist.
Beispiele
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);
}
}
}Ergebnis
0 False
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.