Neu in .NET 9.0 [28]: Feature-Flags

Mit der neuen Annotation [FeatureSwitchDefinition] kann man Bezug auf eine vom Namen her selbst gewählte Projekteinstellung in der Projektdatei nehmen und für bedingte Kompilierung sorgen. Das bedeutet, dass beim Einsatz von Trimming/AOT der Programmcode für deaktivierte Features nicht übersetzt wird.

Im konkreten Beispiel funktioniert das so: Wenn der Feature-Switch "ColorPrinting.IsSupported" auf false steht, wird die Methode Print() beim Trimming entfernt, denn sie wird lediglich an einer Stelle aufgerufen, bedingt von der Eigenschaft IsSupported in der Klasse ColorPrinting.

using System.Diagnostics.CodeAnalysis;
using ITVisions;
 
namespace NET9_Console.FCL90
{
 public class ColorPrinting
 {
  [FeatureSwitchDefinition("ColorPrinting.IsSupported")] // liest Wert aus RuntimeHostConfigurationOption
  internal static bool IsSupported => AppContext.TryGetSwitch("ColorPrinting.IsSupported", out bool isEnabled) ? isEnabled : true;
 
  /// 
  internal static void Print(string s) 
  {
   CUI.Print(s, ConsoleColor.Yellow);
  }
 }
 
 /// 
 class FCL9_FeatureSwitches
 {
  public void Run()
  {
   CUI.Demo(nameof(FCL9_FeatureSwitches));
 
   Console.WriteLine("ColorPrinting.IsSupported=" + ColorPrinting.IsSupported);
 
   // Bedingung auf Feature Switch
   if (ColorPrinting.IsSupported)
   {
    // Dieser Aufruf und damit die ganze Methode Print() wird beim Trimming entfernt, wenn ColorPrinting.IsSupported=false
    ColorPrinting.Print("Ausgabe in Farbe");
   }
   else
   {
    CUI.Print("Keine Farbe");
   }
  }
 }
}

Folgendermaßen aktiviert man obiges Feature durch einen Eintrag in der Projektdatei. Jetzt wird die Methode Print() in der Klasse ColorPrinting beim Trimming nicht entfernt:

Folgendermaßen deaktiviert man obiges Feature durch einen Eintrag in der Projektdatei. Jetzt wird das Trimming die Methode Print() aus der Klasse ColorPrinting entfernen:

(rme)