CilTools.BytecodeAnalysis 2.5.0

CilTools.BytecodeAnalysis

Requirements: .NET Framework 3.5+ or .NET Standard 2.0+

CilTools.BytecodeAnalysis reads .NET methods' Common Intermediate Language (CIL) bytecode and converts it into high-level objects or textual CIL representation so they can be easily studied and programmatically processed. See Documentation and Examples for more information.

Usage

• Import CilTools.BytecodeAnalysis namespace
• Use CilReader.GetInstructions to get the collection of instructions from method
• Use CilGraph.Create to get a graph that represents a flow of control between method's instructions
• Use CilAnalysis.MethodToText when you need to output method's CIL code as text
• CilTools.BytecodeAnalysis.Extensions namespace provides an alternative syntax via extension methods

Example

using System;
using System.Collections.Generic;
using CilTools.BytecodeAnalysis;
using CilTools.BytecodeAnalysis.Extensions;

namespace CilToolsExample
{
    class Program
    {
        public static void Hello()
        {
            int a = 1;
            int b = 2;
            Console.WriteLine("Hello, World");
            Console.WriteLine("{0} + {1} = {2}",a,b,a+b);
        }

        static void Main(string[] args)
        {
            IEnumerable<CilInstruction> instructions = typeof(Program).GetMethod("Hello").GetInstructions();

            foreach (CilInstruction instr in instructions)
            {
                Console.WriteLine(instr.ToString());
            }
            Console.ReadKey();
        }

    }
}

/* Output:

nop
ldc.i4.1
stloc.0
ldc.i4.2
stloc.1
ldstr "Hello, World"
call void [mscorlib]System.Console::WriteLine(string)
nop
ldstr "{0} + {1} = {2}"
ldloc.0
box [mscorlib]System.Int32
ldloc.1
box [mscorlib]System.Int32
ldloc.0
ldloc.1
add
box [mscorlib]System.Int32
call void [mscorlib]System.Console::WriteLine(string, System.Object, System.Object, System.Object)
nop
ret
*/

Copyright (c) 2022, MSDN.WhiteKnight