neuecc / il-visualizer

.NET debugging visualiser for runtime-generated IL code (via DynamicMethod, etc)

Forked

for Visual Studio 2017, remove Non-modal Visualizer.

Built binary is exists in neuecc/il-visualizer/releases page.

IL Visualiser

Originally developed by Haibo Luo in 2005 and posted in a series of blog posts (part one, part two).

Converted to a Git repository and upgraded to Visual Studio 2015 by Drew Noakes

Usage

When paused in the debugger, select an instance of a subclass of MethodBase (such as DynamicMethod, MethodBuilder, ConstructorBuilder, ...) and launch a visualiser:

IL Visualizer (Modal)

Selecting "IL Visualizer" pops up a window showing the IL code.

This window is modal and debugging may only continue once the window is closed.

Installation

(Notes apply to Visual Studio 2015, but are similar for earlier versions)

1. Download the latest release, or build from source

2. Copy ILDebugging.Decoder.dll and ILDebugging.Visualizer.dll to either

   %USERPROFILE%\Documents\Visual Studio 2015\Visualizers

   or

   VisualStudioInstallPath\Common7\Packages\Debugger\Visualizers

3. Restart the debugging session (you don't have to restart Visual Studio)

Earlier Visual Studio Versions

You can target earlier versions of Visual Studio by updating the assembly references for Microsoft.VisualStudio.DebuggerVisualizers.dll to the relevant version.

License

THE CODE IS PROVIDED "AS IS", WITH NO WARRANTIES INTENDED OR IMPLIED. USE AT YOUR OWN RISK!