ILRewriting for beginners

Mattias Högström

Rate me:

4.56/5 (15 votes)

27 Sep 2012Ms-PL11 min read

62K

1.4K

Runtime IL-Rewriting can be used to add behavior such as logging to applications, or redirect calls from one API to another. This article and accompanying source code explains how to substitute a method call at runtime.

ILRewriting_demo.zip
- ILRewriting_demo
  - ILRewriteProfiler.dll
  - InterceptApp.exe
  - InterceptLib.dll
  - License.html
  - README.txt
  - runit.bat
  - SampleApp1.exe
ILRewriting_src.zip
- ILRewriting_src
  - ILEmitTest
    - ILEmitTest.csproj
    - License.html
    - Program.cs
    - Properties
      - AssemblyInfo.cs
  - ILRewriteProfiler
  - ILRewriting.sln
  - InterceptApp
    - app.aps
    - app.ico
    - app.rc
    - AssemblyInfo.cpp
    - ClrHelper.cpp
    - Clrhelper.h
    - InterceptApp.cpp
    - InterceptApp.vcxproj
    - InterceptApp.vcxproj.filters
    - InterceptApp.vcxproj.user
    - License.html
    - ProfileClrApp.cpp
    - ProfileClrApp.h
    - ProfilerStarter.h
    - ProflerStarter.cpp
    - ReadMe.txt
    - resource.h
    - stdafx.cpp
    - stdafx.h
  - InterceptLib
    - DebugLogger.cs
    - InterceptLib.csproj
    - InterceptLib.snk
    - License.html
    - Properties
      - AssemblyInfo.cs
  - License.html
  - SampleApp1
    - License.html
    - Program.cs
    - Properties
      - AssemblyInfo.cs
    - SampleApp1.csproj
    - SampleApp1.snk
ILRewriting_demo-noexe.zip

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="4.0" xmlns="http://schemas.microsoft.com/developer/msbuild/2003">
  <ItemGroup>
    <Filter Include="Source Files">
      <UniqueIdentifier>{4FC737F1-C7A5-4376-A066-2A32D752A2FF}</UniqueIdentifier>
      <Extensions>cpp;c;cc;cxx;def;odl;idl;hpj;bat;asm;asmx</Extensions>
    </Filter>
    <Filter Include="Header Files">
      <UniqueIdentifier>{93995380-89BD-4b04-88EB-625FBE52EBFB}</UniqueIdentifier>
      <Extensions>h;hpp;hxx;hm;inl;inc;xsd</Extensions>
    </Filter>
    <Filter Include="Resource Files">
      <UniqueIdentifier>{67DA6AB6-F800-4c08-8B7A-83BB121AAD01}</UniqueIdentifier>
      <Extensions>rc;ico;cur;bmp;dlg;rc2;rct;bin;rgs;gif;jpg;jpeg;jpe;resx;tiff;tif;png;wav;mfcribbon-ms</Extensions>
    </Filter>
  </ItemGroup>
  <ItemGroup>
    <None Include="ReadMe.txt" />
    <None Include="app.ico">
      <Filter>Resource Files</Filter>
    </None>
  </ItemGroup>
  <ItemGroup>
    <ClInclude Include="stdafx.h">
      <Filter>Header Files</Filter>
    </ClInclude>
    <ClInclude Include="resource.h">
      <Filter>Header Files</Filter>
    </ClInclude>
    <ClInclude Include="ProfilerStarter.h">
      <Filter>Header Files</Filter>
    </ClInclude>
    <ClInclude Include="Clrhelper.h">
      <Filter>Header Files</Filter>
    </ClInclude>
    <ClInclude Include="ProfileClrApp.h">
      <Filter>Header Files</Filter>
    </ClInclude>
  </ItemGroup>
  <ItemGroup>
    <ResourceCompile Include="app.rc">
      <Filter>Resource Files</Filter>
    </ResourceCompile>
  </ItemGroup>
  <ItemGroup>
    <ClCompile Include="InterceptApp.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="AssemblyInfo.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="stdafx.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="ClrHelper.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="ProflerStarter.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
    <ClCompile Include="ProfileClrApp.cpp">
      <Filter>Source Files</Filter>
    </ClCompile>
  </ItemGroup>
</Project>

By viewing downloads associated with this article you agree to the Terms of Service and the article's licence.

If a file you wish to view isn't highlighted, and is a text file (not binary), please let us know and we'll add colourisation support for it.

License

This article, along with any associated source code and files, is licensed under The Microsoft Public License (Ms-PL)

Written By

Mattias Högström

Architect Visma Software AB

Sweden

Mattias works at Visma, a leading Nordic ERP solution provider. He has good knowledge in C++/.Net development, test tool development, and debugging. His great passion is memory dump analysis. He likes giving talks and courses.

ILRewriting for beginners

License

Comments and Discussions