Attributs génériques et plus — Visual Studio Magazine

Nouvelles

Fonctionnalités C# 11 en prévisualisation dans Visual Studio : attributs génériques et plus encore

Un nouveau billet « Quoi de neuf dans C# 11 » explique les nouvelles fonctionnalités disponibles en aperçu avec les derniers outils : NET 6.0.200 SDK ou Visual Studio 2022 v17.1.

Tout d’abord, la prise en charge des attributs génériques ou la possibilité de créer une classe générique basée sur System.Attribute. La classe Attribute permet d’associer des informations au code de manière déclarative, de sorte qu’un ObsoleteAttribute indique un code obsolète et ne doit plus être utilisé, signalant au compilateur de rechercher des instances de l’attribut et de faire quelque chose de correctif en réponse.

Une documentation Microsoft C# 10 pour les attributs génériques (la prise en charge a été reportée à C# 11) explique la motivation : “Actuellement, les auteurs d’attributs peuvent prendre un System.Type en tant que paramètre et demandez aux utilisateurs de passer un typeof expression pour fournir à l’attribut les types dont il a besoin. Cependant, en dehors des analyseurs, il n’y a aucun moyen pour un auteur d’attribut de restreindre les types autorisés à être transmis à un attribut via typeof. Si les attributs pouvaient être génériques, alors les auteurs d’attributs pourraient utiliser le système existant de contraintes de paramètres de type pour exprimer les exigences pour les types qu’ils prennent en entrée.”

Comme le montre le graphique ci-dessous, la prise en charge des attributs génériques n’est qu’une des nombreuses nouvelles fonctionnalités prévues pour C# :

La prise en charge des attributs génériques a été la réponse que l’expert C# Jason Bock a fournie à la question “Quelle est la fonctionnalité C# que vous souhaiteriez que Microsoft propose, mais qui ne s’est tout simplement pas concrétisée ?” dans l’article de septembre 2021 “Q&A with Jason Bock: What’s New in C# 10.”

“Attributs génériques”, a répondu Bock. “C’est une capacité que le CLR a depuis longtemps, mais elle n’a jamais été mise en évidence en C#. Vous pouvez définir des attributs génériques dans le langage intermédiaire de .NET — IL — et les consommer en C#, mais vous pouvez ‘ t les définir directement en C #. Il y a des cas où je pense que cette fonctionnalité serait utile, et j’espère qu’elle le fera en C # à un moment donné.

Ses souhaits se sont réalisés dans Visual Studio 17.1, où un développeur n’a qu’à définir sur “prévisualiser” pour activer les fonctionnalités de prévisualisation. Parmi ceux-ci, “Autoriser les attributs génériques” a été long à venir, en préparation depuis au moins cinq ans.

La nouvelle documentation “Quoi de neuf dans C# 11” vient de paraître le 11 mars fournit plus de détails sur sa manifestation imminente.

“Vous pouvez déclarer une classe générique dont la classe de base est System.Attribute. Cela fournit une syntaxe plus pratique pour les attributs qui nécessitent un paramètre System.Type. Auparavant, vous deviez créer un attribut qui prend un Type comme paramètre constructeur :”

// Before C# 11:
public class TypeAttribute : Attribute
{
  public TypeAttribute(Type t) => ParamType = t;

  public Type ParamType { get; }
}

Après avoir utilisé le tyepof opérateur pour appliquer l’attribut, un développeur peut créer un attribut générique et spécifier le paramètre de type pour utiliser la nouvelle fonctionnalité. Cependant, certaines constructions de code ne sont pas autorisées car lorsqu’un attribut générique est utilisé, il doit être complètement fermé. En d’autres termes, il ne peut contenir aucun paramètre de type. Voici quelques exemples :

• Exemple 1:

  public class GenericType
      {
        [GenericAttribute()] // Not allowed! generic attributes must be fully constructed types.
        public string Method() => default;
      }

• Exemple 2 :

  using System;
      using System.Collections.Generic;
      
      public class Attr : Attribute { }
      
      public class Program
      {
        [Attr] // error
        [Attr] // error
        void M() { }
      }>

En plus d’expliquer la motivation derrière l’approche, Microsoft énumère également un inconvénient du schéma : “Supprimer la restriction, analyser les implications et ajouter les tests appropriés est un travail.”

Une alternative est également répertoriée : “Les auteurs d’attributs qui souhaitent que les utilisateurs puissent découvrir les exigences des types qu’ils fournissent aux attributs doivent écrire des analyseurs et guider leurs utilisateurs pour qu’ils utilisent ces analyseurs dans leurs versions.”

Une question non résolue sur le régime se lit comme suit:

• [x] Que signifie AllowMultiple = false signifie sur un attribut générique? Si nous avons [Attr] et [Attr