Comment un décompilateur lit les intercepteurs C#
Les intercepteurs C# redirigent un appel à la compilation sans laisser de marque au point d'appel ; la seule trace est un attribut InterceptsLocation dont Glass décode le blob base64 pour retrouver un hachage de contenu, une position source et le nom de la méthode interceptée.
Vous décompilez une build de version, ouvrez Program.cs et tombez sur un appel qui ne va plus là où le code source le disait. Le code lit client.GetForecast("NYC"), mais l”IL appelle une méthode statique d”une classe file générée dont vous n”aviez jamais entendu parler. Personne n”a modifié le code source. Le compilateur a recâblé l”appel — et n”a presque rien laissé pour l”expliquer.
C”est un intercepteur C#. C”est l”une des rares fonctionnalités du langage qui change à quelle méthode un appel se lie après que vous l”avez écrit, et c”est délibérément invisible au point d”appel. Pour un décompilateur, c”est un problème : pas d”opcode, pas de modificateur, aucune marque disant « cet appel a été redirigé ». Comprendre votre propre build signifie savoir où vit la seule preuve qui subsiste et comment la lire.
La vraie question
Un intercepteur est une méthode, fournie par un générateur de source, que le compilateur substitue à un appel précis à un emplacement précis du code source. Les API minimales d”ASP.NET Core l”utilisent pour remplacer la tuyauterie de MapGet fondée sur la réflexion par des gestionnaires de requête générés et fortement typés ; les lieurs de configuration et les bibliothèques de mappage font de même. La fonctionnalité est facultative, derrière <InterceptorsNamespaces> dans le fichier projet.
Voici le code de l”utilisateur et l”intercepteur généré :
// Program.cs (what you wrote)
var client = new WeatherClient();
var forecast = client.GetForecast("NYC"); // ← compiler redirects this call
// WeatherClient.g.cs (emitted by a source generator)
namespace Generated;
file static class WeatherInterceptors
{
[global::System.Runtime.CompilerServices.InterceptsLocation(
1, "khAcU2t0b2tlbgAAAABQAAAAUHJvZ3JhbS5jcw==")]
public static Forecast GetForecast_Fast(this WeatherClient client, string city)
{
// generated fast path, no reflection
}
}
Le compilateur voit que GetForecast_Fast revendique l”emplacement de l”appel à GetForecast et émet à la place un appel à l”intercepteur. La question à laquelle un décompilateur doit répondre est : à partir du seul assembly, comment retrouver le fait que l”interception a eu lieu, et quelle était la cible d”origine ?
Le point d”appel ne vous dit rien
Commencez là où votre instinct vous dit de regarder : l”appel lui-même. L”IL émis pour cette ligne est un appel ordinaire :
ldloc.0 // client
ldstr "NYC"
call class Generated.Forecast
Generated.WeatherInterceptors::GetForecast_Fast(
class WeatherClient, string)
Il n”y a aucun WeatherClient::GetForecast où que ce soit dans ce corps de méthode. La cible d”origine n”est pas référencée, pas commentée, pas signalée. Du point de vue de l”IL, vous avez simplement écrit un appel à GetForecast_Fast. Un décompilateur qui rend cela fidèlement vous montrera exactement cela — ce qui est correct, car c”est ce qui s”exécute —, mais cela masque la réécriture. L”interception est une décision de liaison cuite dans le jeton d”appel ; rien ne subsiste au point d”appel pour l”annuler.
Le seul endroit où la redirection est consignée est donc la méthode intercepteur, sous forme d”attribut personnalisé.
Décoder le blob InterceptsLocation
InterceptsLocationAttribute est émis dans les métadonnées comme n”importe quel autre attribut personnalisé. La forme actuelle (version 1) prend deux arguments : un int de version et un blob string de données :
.method public hidebysig static class Forecast
GetForecast_Fast(class WeatherClient client, string city) cil managed
{
.custom instance void
System.Runtime.CompilerServices.InterceptsLocationAttribute::.ctor(int32, string)
= ( 01 00 01 00 00 00 24 6B 68 41 63 55 32 74 30 62 32 74 6C 62 ... 00 00 )
Lisez ce blob de CA selon les règles d”ECMA-335. 01 00 est le prologue. 01 00 00 00 est le premier argument fixe, l”int32 de version 1. Vient ensuite l”argument string sous forme de SerString : une longueur en entier compressé (0x24 = 36 octets) suivie des octets UTF-8 du texte base64. Le 00 00 final est le nombre d”arguments nommés, zéro.
Cette chaîne base64 est elle-même un enregistrement binaire compacté. Décodez-la et vous obtenez trois champs disposés l”un après l”autre :
byte[] blob = Convert.FromBase64String(data);
// 1) 16-byte content hash of the intercepted source file (XxHash128 in current Roslyn)
ReadOnlySpan<byte> contentHash = blob.AsSpan(0, 16);
// 2) position of the intercepted name token, as an ECMA-335 compressed unsigned integer
int offset = 16;
int position = ReadCompressedUInt(blob, ref offset);
// 3) a display name for the file, UTF-8, to the end of the blob
string displayName = Encoding.UTF8.GetString(blob, offset, blob.Length - offset);
Maintenant l”attribut signifie quelque chose de concret. Il dit : cette méthode intercepte l”appel dont le jeton de nom commence au caractère position dans un fichier dont le contenu a pour hachage contentHash, montré aux humains comme displayName. Glass effectue exactement ce décodage lorsqu”il rencontre un attribut InterceptsLocation, de sorte que la méthode intercepteur dans l”arbre des types est étiquetée avec la position et le fichier qu”elle revendique, au lieu de vous montrer une chaîne base64 opaque.
De la preuve à la compréhension
Réunissez les deux moitiés et la réécriture devient lisible. Parcourez l”arbre des types à la recherche des méthodes portant InterceptsLocation ; chacune est un intercepteur. Sa signature vous indique la forme de l”appel qu”elle a remplacé : un premier paramètre de style extension this WeatherClient signifie qu”elle se substitue à un appel d”instance sur WeatherClient, et le nom de méthode choisi par le générateur (GetForecast_Fast) fait souvent écho à l”original. Puis recoupez : cherchez dans l”assembly les appels directs à cet intercepteur, et ces points d”appel sont les endroits que le compilateur a redirigés. La position et le displayName décodés vous disent quel fichier source et, approximativement, où, si vous avez le code source à confronter au hachage.
Dans Glass, les méthodes intercepteurs apparaissent avec leur emplacement décodé dans la vue IL, et le blob d”attribut est développé au lieu d”être montré brut, de sorte que vous voyez d”un coup d”œil qu”une méthode générée revendique un point d”appel, ce qui est l”indice qu”un appel d”apparence banale ailleurs n”est pas ce qu”il semble.
Quand cela casse
Soyez honnête sur les limites, car elles sont réelles.
- Pas de source, pas de numéro de ligne. Le blob de la version 1 est délibérément relatif à la source. Le hachage de contenu et la position de caractère ne sont résolubles que si vous avez le fichier d”origine pour le hacher et l”indexer. Sans lui, vous apprenez *qu”*un appel a été intercepté et son nom affiché, jamais la ligne exacte. C”est intentionnel : l”encodage échange la lisibilité contre une résistance aux modifications d”espaces blancs.
- Le point d”appel est réellement propre. N”allez pas chercher un modificateur ou une marque sur l”appel redirigé. Il n”y en a pas. La redirection ne vit que sur l”intercepteur, donc un décompilateur qui n”inspecte pas les attributs personnalisés manquera entièrement la fonctionnalité et affichera un appel qui semble écrit à la main.
- La forme héritée se lit différemment. L”encodage original en préversion était
[InterceptsLocation(string filePath, int line, int character)]: lisible par un humain, mais fragile et désormais dépassé. Vous pouvez encore le rencontrer dans d”anciens assemblys ; décodez-le comme trois arguments simples, pas comme un blob. - C”est encore une fonctionnalité facultative et mouvante. Les intercepteurs vivent derrière
<InterceptorsNamespaces>, et la forme de l”attribut a déjà changé une fois. Traitez la disposition exacte des octets comme dépendante de la version et lisez d”abord l”argument de version.
À retenir
Les intercepteurs sont le cas où la décompilation honnête et la décompilation utile divergent. L”IL qui s”exécute est un appel direct à une méthode générée, et le rendre fidèlement est correct, mais cela masque une réécriture à la compilation. Toute l”histoire est repliée dans un attribut personnalisé sur l”intercepteur, et le lire signifie décoder un enregistrement base64 d”un hachage de contenu, d”une position source et d”un nom. Glass fait ce décodage pour vous, ce qui fait la différence entre voir un appel à GetForecast_Fast et comprendre que votre propre appel à GetForecast a été remplacé en silence.
Glass.NET est un décompilateur .NET gratuit. Consultez la page du produit et la documentation.
Essayez Nebula.NET
Renforcez votre code .NET en quelques minutes — commencez avec l'édition gratuite.