Wie quellgenerierter P/Invoke dekompiliert
Klassische [DllImport]-Methoden haben keinen verwalteten Rumpf, daher rekonstruiert ein Dekompiler sie aus der ImplMap-Tabelle. Eine [LibraryImport]-Methode ist das Gegenteil: der Marshalling-Stub ist echter kompilierter C#-Code, und Glass zeigt ihn vollständig.
Dekompilieren Sie eine mit [DllImport] markierte Methode, und Sie bekommen fast nichts zurück: eine extern-Signatur, ein rekonstruiertes Attribut und keinen Rumpf. Dekompilieren Sie eine mit [LibraryImport] markierte Methode, und Sie erhalten eine Seite voll echtem C#: fixed-Blöcke, Zeigerkonvertierungen, einen verschachtelten Aufruf. Derselbe native Aufruf, völlig unterschiedliche dekompilierte Ausgabe. Der Grund liegt darin, wo der Marshalling-Code wohnt, und es lohnt sich, das zu verstehen, denn es ändert, was man beim Lesen einer Assembly über sie lernen kann.
Die eigentliche Frage
Beide Attribute beschreiben dasselbe: eine verwaltete Methode, die in Wahrheit ein Aufruf über die native Grenze hinweg ist. Warum überlebt die eine also die Dekompilierung als leere Hülle und die andere als vollständig lesbare Methode? Die Antwort: Das klassische [DllImport] überlässt das gesamte Marshalling der CLR zur Laufzeit, während [LibraryImport] — der in .NET 7 eingeführte Quellgenerator — das Marshalling zur Kompilierzeit als C# ausschreibt. Das eine lässt den Stub in der Laufzeit; das andere backt ihn in Ihre Assembly ein.
Klassisches DllImport: eine Methode ohne Rumpf
Beginnen wir mit dem alten Stil:
[DllImport("user32.dll", EntryPoint = "MessageBoxW",
CharSet = CharSet.Unicode, ExactSpelling = true)]
internal static extern int MessageBox(IntPtr hWnd, string lpText, string lpCaption, uint uType);
In den Metadaten ist diese Methode ungewöhnlich. Ihre MethodDef-Zeile trägt das pinvokeimpl-Flag, und sie hat kein CIL. Die Deklarationsdaten liegen in einer separaten Metadatentabelle, ImplMap, die die Methode mit einem ModuleRef (user32.dll), dem Importnamen (MessageBoxW) und einer Reihe von Flags verknüpft, die Zeichensatz, Aufrufkonvention und SetLastError kodieren. Wenn Sie sie in Glass öffnen, zeigt die IL-Ansicht eine leere Methode, und der Dekompiler rekonstruiert das Attribut aus der ImplMap-Zeile:
// dekompiliert — der Rumpf ist wirklich nicht hier
[DllImport("user32.dll", EntryPoint = "MessageBoxW", ExactSpelling = true)]
internal static extern int MessageBox(IntPtr hWnd, string lpText, string lpCaption, uint uType);
Wo ist also der Code, der eine string in ein char* verwandelt und auf den nativen Stapel legt? Er existiert nicht in der Assembly. Die CLR baut beim ersten Aufruf der Methode einen Marshalling-Stub, geleitet von den ImplMap-Flags und der Signatur. Dieser Stub wird vom JIT im Speicher kompiliert und beim Prozessende verworfen. Ein Dekompiler kann ihn nie zeigen, weil er nie auf der Festplatte war.
LibraryImport: der Stub wird zu C#
Nun die quellgenerierte Form. Die Methode ist partial, und das Attribut sitzt auf einer Deklaration ohne Rumpf:
[LibraryImport("user32.dll", EntryPoint = "MessageBoxW",
StringMarshalling = StringMarshalling.Utf16)]
internal static partial int MessageBox(IntPtr hWnd, string lpText, string lpCaption, uint uType);
Zur Kompilierzeit liefert der LibraryImportGenerator die andere Hälfte der partiellen Methode. Es ist gewöhnlicher C#-Code — und er ist das, was in Ihrer Assembly landet:
internal static unsafe partial int MessageBox(IntPtr hWnd, string lpText, string lpCaption, uint uType)
{
int __retVal;
fixed (char* __lpText_native = lpText)
fixed (char* __lpCaption_native = lpCaption)
{
__retVal = __PInvoke(hWnd, (ushort*)__lpText_native, (ushort*)__lpCaption_native, uType);
}
return __retVal;
// der eigentliche Grenzübertritt — eine lokale Funktion
[DllImport("user32.dll", EntryPoint = "MessageBoxW", ExactSpelling = true)]
static extern int __PInvoke(IntPtr hWnd, ushort* lpText, ushort* lpCaption, uint uType);
}
Lesen Sie, was der Generator getan hat. Da StringMarshalling.Utf16 dem UTF-16-Layout der CLR-string entspricht, ist keine Kopie nötig: Die beiden Strings werden mit fixed fixiert, ihre Zeiger als ushort* neu interpretiert und direkt durchgereicht. Der eigentliche native Aufruf ist eine verschachtelte lokale static extern-Funktion — immer noch ein klassisches [DllImport], aber jetzt ein privates, vom Compiler benanntes Implementierungsdetail. Die öffentliche Methode ist reiner, sichtbarer Marshalling-Kleber.
Was Glass tatsächlich zeigt
Die verschachtelte lokale [DllImport]-Funktion behält in der kompilierten Assembly keinen freundlichen Namen. C# senkt lokale Funktionen zu privaten statischen Methoden mit einem verstümmelten (mangled) Namen ab, sodass Sie in den Metadaten etwas wie <MessageBox>g__PInvoke|0_0 sehen. Wenn Sie die Assembly in Glass öffnen, erkennt der Dekompiler das Mangling und stellt es wieder als lokale Funktion innerhalb von MessageBox dar, nahe an der generierten Quelle oben. Wechseln Sie zur IL-Ansicht, und Sie können die Aufteilung direkt bestätigen:
.method assembly hidebysig static int32 MessageBox (...) cil managed
{
// echtes IL: ldarg, conv, das fixed-pin-Muster, call zu __PInvoke
}
.method assembly hidebysig static pinvokeimpl("user32.dll" ...) int32 '<MessageBox>g__PInvoke|0_0' (...) cil managed { }
Nur die zweite Methode trägt pinvokeimpl. Das ist der einzige echte Grenzübertritt. Alles andere — das Fixieren, die Zeigerkonvertierung, die Rückgabebehandlung — ist Code, den der Generator geschrieben hat und den Sie nun lesen können. Für einen UTF-8-String-Parameter wäre der Stub länger: Er reserviert einen nativen Puffer, ruft den UTF-8-Marshaller zum Transkodieren auf, nutzt den Puffer und gibt ihn dann in einem finally frei. Auch das alles ist dekompilierbar, weil es alles echtes IL ist.
Warum das beim Lesen einer Assembly zählt
Das ist keine Kuriosität: Es ändert, welche Interop Sie per Inspektion prüfen können. Bei einer klassischen [DllImport]-Oberfläche verrät Ihnen das Lesen der Assembly den Einstiegspunkt und die deklarierte Signatur, aber nichts darüber, wie die Argumente tatsächlich gemarshallt werden; die Wahrheit steckt in den Laufzeitregeln der CLR. Bei [LibraryImport] ist das Marshalling direkt da. Sie sehen genau, welche Puffer fixiert werden, wo ein Transkodieren Speicher reserviert, ob ein bool als 4-Byte-int oder als 1-Byte-Wert gemarshallt wird und wann der Speicher freigegeben wird. Zum Prüfen einer Interop-Schicht, zu deren Inspektion Sie berechtigt sind — Ihr eigener Build, eine Abhängigkeit, die Sie bewerten, ein Absturz, den Sie debuggen — ist die quellgenerierte Form weitaus transparenter.
Es verrät Ihnen auch etwas über die Herkunft. Eine Bibliothek, die [LibraryImport] verwendet, wurde für .NET 7 oder neuer mit aktiviertem Generator gebaut, und sie ist von Natur aus AOT-freundlich, gerade weil der Stub statischer Code statt zur Laufzeit erzeugtem IL ist. Die g__PInvoke-Methoden in Glass zu sehen, ist ein schnelles Signal für eine moderne, trimming- und AOT-fähige Interop-Schicht.
Vorbehalte
Der dekompilierte Stub ist getreues C#, aber es ist das C# des Generators, nicht Ihres: Erwarten Sie nicht, dass es mit handgeschriebenem Marshalling übereinstimmt, das Sie für denselben Aufruf schreiben würden. Die Namen der generierten lokalen Funktionen (g__PInvoke|0_0) sind Compiler-Artefakte und können sich zwischen Compilerversionen ändern, behandeln Sie sie also nicht als stabile API. Und die verschachtelte Methode ist weiterhin ein echtes [DllImport]: Der letzte Sprung in den nativen Code ist so undurchsichtig wie eh und je — Glass zeigt Ihnen das verwaltete Marshalling, nicht die native Funktion, in der er landet. Wird die Assembly mit einem PDB ausgeliefert, kann Glass zudem die ursprünglichen Argumentnamen wiederherstellen und den Stub noch leichter nachvollziehbar machen; siehe Namen aus einem PDB wiederherstellen.
Fazit
[DllImport] versteckt sein Marshalling in der Laufzeit; [LibraryImport] schreibt es in Ihre Assembly. Dieser eine Unterschied ist der Grund, warum das eine zu einer leeren Hülle und das andere zu einem lesbaren Stub dekompiliert. Wenn Sie verstehen müssen, wie ein Interop-Aufruf seine Argumente wirklich über die Grenze bewegt, öffnen Sie ihn in Glass.NET — und hoffen Sie, dass er mit dem Generator gebaut wurde. Glass ist ein kostenloser, offener .NET-Dekompiler mit einer VS-nativen Oberfläche, einer CLI und einem MCP-Server.
Nebula.NET testen
Härten Sie Ihren .NET-Code in wenigen Minuten — starten Sie mit der kostenlosen Edition.