Comment Glass reconstruit un bloc d'extension C# 14
Un bloc d'extension C# 14 est abaissé en un type imbriqué squelette caché plus des méthodes statiques ordinaires sur la classe conteneur. Cet article parcourt les métadonnées que Glass.NET lit pour apparier les deux moitiés et reconstruire le bloc d'extension, y compris ses propriétés d'extension et ses membres statiques, que la forme classique à paramètre this n'a jamais pu exprimer.
C# 14 a enfin permis d”écrire list.IsEmpty et Point.Origin, où IsEmpty et Origin sont vos ajouts à des types que vous ne possédez pas. L”astuce classique du paramètre this n”a jamais pu le faire : elle n”ajoutait que des méthodes, parce qu”un accesseur de propriété n”a pas de premier paramètre à marquer. Le nouveau bloc d”extension comble ce vide. Et comme le vide était dans le langage, pas dans le runtime, le compilateur a dû inventer une forme de métadonnées pour le transporter. Décompiler cette forme pour retrouver un bloc lisible est un casse-tête à deux moitiés, et cet article le parcourt pour Glass.NET.
Le code source
Un unique bloc d”extension qui ajoute une propriété d”instance, une méthode d”instance et une propriété statique à IEnumerable<T> :
public static class EnumerableExtensions
{
extension<T>(IEnumerable<T> source)
{
public bool IsEmpty => !source.Any();
public IEnumerable<T> WhereNotNull()
=> source.Where(x => x is not null);
public static IEnumerable<T> Empty => [];
}
}
Trois membres, un récepteur nommé source. Rien ici ne correspond à une méthode d”extension classique sauf, vaguement, WhereNotNull. IsEmpty est une propriété ; Empty est un membre statique auquel on accède comme EnumerableExtensions.Empty sans aucun récepteur. Aucune syntaxe à paramètre this n”exprime quoi que ce soit de cela.
Ce que le compilateur émet
Le récepteur et les signatures des membres ne survivent pas en tant que C#. Ils survivent sous la forme d”un type imbriqué que le compilateur synthétise à l”intérieur de EnumerableExtensions, un par bloc d”extension, avec un nom imprononçable comme <>E__0. Ce type imbriqué est le squelette. Son membre le plus important est une méthode marqueur nommée <Extension>$ dont l”unique paramètre est le récepteur :
.class nested public abstract sealed auto ansi beforefieldinit '<>E__0'<T>
{
.method public hidebysig specialname static
void '<Extension>$'(class [System.Runtime]System.Collections.Generic.IEnumerable`1<!T> source) { }
.property instance bool IsEmpty() { .get instance bool get_IsEmpty() }
.method public hidebysig specialname instance bool get_IsEmpty() { ldnull throw }
.method public hidebysig instance class IEnumerable`1<!T> WhereNotNull() { ldnull throw }
.property class IEnumerable`1<!T> Empty() { .get static class IEnumerable`1<!T> get_Empty() }
.method public hidebysig specialname static class IEnumerable`1<!T> get_Empty() { ldnull throw }
}
Deux choses à remarquer. Le nom du récepteur — source — est conservé, comme nom du paramètre de <Extension>$. Et tous les corps du squelette sont ldnull; throw. Ces méthodes ne s”exécutent jamais ; elles n”existent que pour que la forme publique de chaque membre (nom, signature, attributs, statique-ou-instance) vive dans les métadonnées indépendamment du code qui l”implémente.
Le code qui s”exécute réellement réside sur la classe statique conteneur, sous des noms mutilés basés sur le contenu, avec le récepteur inséré comme véritable premier paramètre pour les membres d”instance :
.class public abstract sealed auto ansi beforefieldinit EnumerableExtensions
{
.method public hidebysig static bool
get_IsEmpty<T>(class IEnumerable`1<!T> source)
{
ldarg.0 call bool [System.Linq]System.Linq.Enumerable::Any<!!T>(...)
ldc.i4.0 ceq ret
}
.method public hidebysig static class IEnumerable`1<!T>
WhereNotNull<T>(class IEnumerable`1<!T> source) { /* real body */ }
.method public hidebysig static class IEnumerable`1<!T>
get_Empty<T>() { /* real body, no receiver */ }
}
Les membres d”instance (get_IsEmpty, WhereNotNull) prennent source comme premier paramètre. Le membre statique (get_Empty) non : un membre d”extension statique n”a pas de récepteur, donc son implémentation est une méthode statique générique ordinaire. Cette asymétrie est le signal le plus utile de tout le schéma : c”est ainsi qu”un décompilateur décide si un membre entre dans le bloc comme static ou comme membre d”instance.
L”appariement
La reconstruction est une jointure. Pour chaque membre squelette de <>E__0, Glass trouve l”implémentation correspondante sur la classe conteneur et y lit le corps ; il lit la forme — nom, type de retour, statique-ou-instance, attributs — depuis le squelette ; et il lit le récepteur une seule fois, depuis <Extension>$, pour mettre source dans la portée de chaque corps d”instance.
La décision statique-ou-instance découle directement de la liste des paramètres de l”implémentation. get_IsEmpty<T>(IEnumerable<T> source) a le récepteur comme premier paramètre, donc IsEmpty est un membre d”instance et son corps est imprimé avec source dans la portée. get_Empty<T>() n”a pas de récepteur, donc Empty est static et seule le paramètre de type est dans sa portée. Glass n”a pas à se fier au seul drapeau static du squelette : la forme de l”implémentation le confirme.
Le résultat est le bloc, réassemblé à l”identique :
public static class EnumerableExtensions
{
extension<T>(IEnumerable<T> source)
{
public bool IsEmpty => !source.Any();
public IEnumerable<T> WhereNotNull() => source.Where(x => x is not null);
public static IEnumerable<T> Empty => [];
}
}
Comment vous utilisez cela
Pointez Glass vers n”importe quel assembly qui cible .NET 10 ou ultérieur et utilise des blocs d”extension — vos propres bibliothèques, une dépendance sous licence dont vous avez perdu le code source, un paquet contre lequel vous déboguez un problème d”interopérabilité. Dans l”arborescence, la classe conteneur affiche ses membres ; dépliez le type synthétisé <>E__0 et Glass rend le bloc extension récupéré au lieu d”un simple type imbriqué rempli de stubs qui lèvent. Les surfaces CLI et MCP vous donnent la même reconstruction pour une revue scriptée :
glass decompile EnumerableExtensions.dll --type EnumerableExtensions
Si vous voulez seulement confirmer le récepteur et la liste des membres sans les corps, la vue IL montre directement la méthode marqueur <Extension>$ et les squelettes, qui sont la vérité de base sur laquelle la vue C# est construite.
Quand ça casse
L”appariement se fait par signature, et les collisions de signature sont là où cela s”effiloche. Si deux blocs d”extension dans la même classe déclarent des membres dont les implémentations abaissées mutilent vers des formes qu”un outil ne peut pas distinguer, un décompilateur peut rattacher un corps au mauvais squelette ; Glass base la jointure sur la signature générique complète et le type du récepteur pour l”éviter, mais des assemblies mutilés de manière adverse peuvent toujours tromper n”importe quel lecteur. Une deuxième limite est le mélange : une classe peut contenir à la fois des méthodes d”extension classiques à paramètre this et de nouveaux blocs d”extension, et les deux utilisent des métadonnées distinctes — l”attribut [Extension] pour les anciennes, le squelette <>E__N pour les nouvelles — de sorte qu”une décompilation fidèle montre chacune dans sa propre forme au lieu d”en forcer une dans l”autre. Enfin, les noms imprononçables (<>E__0, <Extension>$) sont internes au compilateur et ont changé d”une préversion à l”autre ; Glass reconnaît la forme, pas un nom codé en dur, mais un abaissement futur pourrait déplacer l”encodage et nécessiter une mise à jour du lecteur.
À retenir
Un bloc d”extension est un regroupement à la compilation sans existence au runtime, scindé à la compilation en un squelette qui se souvient de la forme et une implémentation qui porte le code. Le reconstruire est une jointure : lire le récepteur une fois depuis <Extension>$, apparier chaque membre squelette à son implémentation et laisser le premier paramètre de l”implémentation décider de l”instance ou du statique. Réussissez cette jointure et une propriété d”extension — une chose que l”ancienne syntaxe n”a jamais pu écrire — revient exactement telle qu”elle a été écrite.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.