Type forwarding using TypeForwardedTo attribute in Runtime.CompilerServices

We used this feature to solve a problem internally and I was tempted to blog about this cool feature. Type forwarding allows you to move a type from one assembly to another without having to recompile the application that uses the original assembly.


Here is how this works:


Writing the original library (original.cs)


using System;

public class ClassToBeForwardedLater


    public void SomeMethod()


        Console.WriteLine("Inside ClassToBeForwardedLater in Original.dll");




Let us compile this to original.dll as below


csc /t:library original.cs


Building the application using the original assembly (application.exe)


using System;

class Application


    public static void Main()


        ClassToBeForwardedLater ctbf = new ClassToBeForwardedLater();





Let us compile the executable as below


csc /r:original.dll application.cs


Let us run application.exe. You will get the following output


Inside ClassToBeForwardedLater in Original.dll


Re-implementing the original assembly in a new assembly (newlibrary.cs)


using System;

public class ClassToBeForwardedLater


    public void SomeMethod()


        Console.WriteLine("Inside ClassToBeForwarded in newlibrary");




Let us compile the newlibrary.dll as below


csc /t:library newlibrary.cs


Re-publish the original assembly, but this time with a type forwarded


using System;

using System.Runtime.CompilerServices;



      Let us compile the original library as below


csc /t:library /r:newlibrary.dll original.cs


Let us run application.exe again and see what we get.


Inside ClassToBeForwardedLater in newlibrary


The method in the newlibrary is invoked though the application was built with a reference to original.dll. If you do ildasm on application.exe and view the metadata section you will see a reference to original.dll.

Comments (12)

  1. Muthu says:

    Good simple example. Nice work.


  2. Thottam Sriram says:

    Thanks Muthu for the feedback. Makes me feel good when I read comments like this.

  3. Krishnan says:

    I read the COM Interop article on MSDN mag and thought I’d look up your blog.  I learnt new things from your blog.  I’ll keep checking frequently.  

  4. Thottam Sriram says:

    Thanks Krishnan. Did you find the article useful? I am planning on writing another article on COM interop, do you have any thoughts for this?

  5. swap says:

    May be it’s just me, but i don’t see any practical use of this attribute. I mean if you can modify original dll then you might as well change somemethod() instead of forwarding to to other class. You mentioned that you used it to solve some problem internally, may be you can tell us what was that problem.

  6. Rob says:

    Swap – just because *you* can modify the original DLL, it doesn’t mean it’s practical or sensible to change "somemethod()" in that DLL, or even that modifying the method is your objective.

    The first example I can think of, off the top of my head is of a library / helper assembly that contains many, many different classes. Over time it’s grown and contains, maybe a custom UI library from Company X, who’ve now realised that it’d be sensible to split it in two, for WinForms and WebForms. Instead of forcing a recompile on all down-level clients from doing this, three new DLLs can be issued, a UILibrary.dll (the original assembly), UILibrary.WinForms.dll and UILibrary.WebForms.dll. UILibrary.dll would maintain exactly the same interface/class structure as previously but point to classes in the two new DLLs. New clients could bind only the DLL they need (web apps use WebForms, win apps use WinForms, etc,..)

    In fact – I have a strong suspicion I’ll be doing something pretty much identical to my example with some code at work shortly!

  7. Jay says:

    Very clear example, Thanks, but I have a doubt!

    We specify


    in the original assembly but where does this assembly point to the new one for that method.

    In other words, how does the main application know that func1 method, which was in the original ‘aaa’ assembly is now in new ‘bbb’ and not in a new ‘ccc’ assembly.


  8. Gopinath says:

    Thanks for a nice example. It is very informative, but for making it also good for the beginers, include the type of project that they have to deal with. I was just going through some questions of MCTS and this was one of the questions. Good going !!!

  9. Ali says:

    hey jay according to my understanding the runtime knows in which assembly the Type has been forwarded to   because we have included the reference in the compile statement

    csc /t:library /r:newlibrary.dll original.cs

    Another thing you can do is add the

    using newlibrary.cs in the  orignal.cs file

    If you have more then one assembly having the same Type eg. ClassToBeForwardedLater. What you can do is give the complete name of the type like this

    using AssemblyB.cs


    so that the compiler knows which assembly we are talking about .

    this is my first time writing a blog , I request all you out there to please comment and let me know if i am right or wrong

    my email add is alimalik03a@yahoo.com

  10. Thottam Sriram says:

    Ali is right. It gets the reference from the reference during compilation.

    Gopinath, I didn’t understand your question. What do you mean by the type of project? Are you referring to the project in Visual Studio?

  11. Ali.Net says:

    Thanks for such a nice explanation Mr. Sriram.

    And also thanks for all the contributors to the comments specially Ali and Rob to explain further details regarding the subject.



Skip to main content