Creating and Using C# DLLs


Desktop-as-a-Service Designed for Any Cloud ? Nutanix Frame

Environment: C#


In this article, I would like to explain how to create and use DLLs in C Sharp. Before writing code, we will examine some basics of a DLL in the .NET framework; for example, how it's loaded in the process address space, how CLR is initialized, and the mechanism behind the screen. First, we will talk about MSCorEE.dll; you will find this guy in the %windir%\system32\ directory. MSCorEE.dll stands for Microsoft Component object runtime Execution Engine. The existence of this file tells you that you have installed the .NET framework in your system. This DLL is responsible for initializing the CLR.

Whenever you create an assembly, the compiler/linker emits the following 6-byte x86 stub function into the PE file's .text section:

JMP _CorExeMain for Exe or JMP _CorDllMain for Dll.

Figure 1 shows the Portable Executable (PE) file format. This stub function is implemented inside the MSCorEE.dll. So, this dll must be referenced somewhere in the PE file. Yes, your guess is right; it's referenced in the .idata section of the PE file. The .idata section is used to refer import libraries for assembly.

Figure 1—The PE file format.

We have given all the hints and clues to the Windows loader, so here we go.... When the managed assembly file is invoked, the Windows loader completes the following steps:

  1. Loads the PE file, parses the .idata section, and loads MSCorEE.dll (if it's not already loaded) into the process's address space.
  2. Takes the address of _CorExeMain in the case of an Exe assembly, or _CorDllMain in the case of a DLL assembly function, inside the MSCoreEE.dll.
  3. Using the address from Step 2, the Windows loader fixes the stub function JMP instruction (from the .text section PE).

At this point, the process's primary thread starts executing the stub function; that is, it jumps to _CorExeMain for Exe or _CorDllMain for Dll in the MSCorEE.dll. The _CorExeMain or _CorDllMain initializes the CLR and looks for a managed entry point from the assembly's CLR header and starts executting. Here the IL code for the method is compiled into native CPU instructions and the CLR jumps to native code. That's it; the managed applications code is running.

The framework differentiates between managed executive and managed DLL files because of the stub function stored in the .text section of the PE file. For Exe, the stub function is JMP _CorExeMain and for Dll the stub function is JMP _CorDllMain. The Windows loader differentiates this function and fixes the corresponding address from the MSCorEE.dll.

I think now we know how a managed exe/dll loads in the process address space and how CLR gets initialized. Okay, time for coding. Here we develop a small DLL and a test container for that. This DLL will export three functions, each from one class in a namespace.

Open a new C# WindowsApplication project in Visual Studio .NET. Name the Project MathFunctions.

Add the following three classes to this project. Name them something like AddClass.cs, MultiClass.cs, and FactorialClass.cs.

Listing 1. AddClass.cs

using System;

namespace MathFunctions
  public class AddClass
    public static int Add(int a, ant b)
      return (a+b);

Listing 2. MultiClass.cs

using System;

namespace MathFunctions
  public class MultiClass
    public static int Multiply(int a, int b)
      return (a*b);

Listing 3. FactorialClass.cs

namespace MathFunctions
  public class FactorialClass
    public static int Factorial(int i)
      return((i <= 1) ? 1 : (i * Factorial(i-1)));


Our idea is to export AddClass::Add, MultiClass:: Multiply, and FactorialClass::Factorial from the namespace MathFunctions. That's it; we're finished coding.

Go to the command line and type the following.

CSC /target:library /out:MyFunctions.dll AddClass.cs
     MultiClass.cs FactorialClass.cs

Go to the command line option /target:library and ask the C Sharp Compiler/Linker to output a DLL instead of an EXE. It's possible to have a different name for the DLL; for example, /out:MyFunctions.dll directs the compiler to output the DLL with the name MyFunctionsLib; otherwise, it will take the default name from the first .cs file. Here, it's AddClass.dll.

Now comes the test container for this DLL. Create a new WindowsApplication project by right-clicking the solution in the Solution Explorer pane. Name it DllTestApp.

Add the following line to the Using section.

using MathFunctions;

Add the following code to the click of button1.

private void button1_Click(object sender, System.EventArgs e)
int add = AddClass.Add(125,125);
  int mul = MultiClass.Multiply(25,25);
  int fac = FactorialClass.Factorial(5);

  string str = "Addition result = " + add.ToString() + "\n"
       + "Multiplication result = " + mul.ToString() + "\n"
       + "Factorial result = " + fac.ToString();

  MessageBox.Show(str, "MyDllTestDialog");


To refer to the DLL in our project, right-click the project's reference and click Add Reference. This displays tabbed panes that list the various types of components and projects you can browse. On the .NET tab, click the Brows button and browse for the DLL to which you want to refer (here, MyFunctions.dll), and click OK.

This solves the problem of DLL hell or version problems. Any change in the DLL will be reflected as we refer in this project.

Any suggestions and criticisms, please drop an e-mail to rishibala@hotmail.com.


Download demo project - 40 Kb


  • Please help

    Posted by fredzy on 01/14/2016 11:00pm

    I'm trying to build .dlls for some of my class files that have reference to other assemblies and I'm getting error. How should I do it? I have a class file say class1.cs and in that class1.cs I have reference to other assemblies and namespaces that are located on other hierarchy of the project. When I run csc command I get this "error CS0246: The type or namespace name 'Test' could not be found (are you missing a using directive or an assembly reference?)" Please help

  • thanks

    Posted by Ratul on 12/18/2015 11:25am

    useful stuff...... im building a custom shell in wpf.... this will help a lot for that

  • Can the DLL be compiled for access in VBA?

    Posted by Steve on 04/16/2013 06:12pm

    I have built some code based on this and it builds a DLL file, however when I try and use the DLL in a VBA {Private Declare Function fLogOn Lib "C:\Contron\My.DLL" Alias "logon" (PW As String) As Boolean)} it wont find the function. I am trying to hide some script from the end user by writting the code in a DLL. HELP!!!!

  • Date type dll

    Posted by manna on 08/14/2012 10:04am

    I want dll file for date. So i can add this dll file in visual studio. So I can drag and drop like date time picker. This dll file is like this: 1there is one textbox like dd/mm/yyyy writen by default. 2when i click on dd it is editable. 3all dd , mm, yyyy are with validation.

    • DateTime

      Posted by mahndra on 09/08/2014 05:38am


  • dll

    Posted by VIJAY JADHAV on 07/07/2012 09:57am

    how i create dll for marathi font in c#

  • How to register the dll?

    Posted by joesukhum on 11/15/2008 12:14am

    When I install the dll in Windows system32 folder, the exe couldn't find the dll any more. I did both register within an installation and manually, but they don't work. Any idea?

    • re:how to register dll

      Posted by Heath Jones on 08/29/2014 05:28pm

      you need to add a "reference" to the dll. not actually add the dll to the project. Then you will be able to use the namespace.

  • Fantastic!!

    Posted by Legacy on 09/17/2003 07:00am

    Originally posted by: Eradication

    I loved it! Worked perfectly! Great job! =D

  • call new c# code from old c++ code

    Posted by Legacy on 04/02/2003 08:00am

    Originally posted by: vibhesh

    I want to develop some dialogs using c#, and need to invoke that dialog from my existing c++ code (unmanaged code compiled by VC 6.0)

  • Nice article

    Posted by Legacy on 10/07/2002 07:00am

    Originally posted by: venkat

    Well explained to understand .Net executable.


  • mixing with VC++

    Posted by Legacy on 09/29/2002 07:00am

    Originally posted by: mcl2

    Can you load a C# dll into a Visual C++ application? For example, I would like make use of the regular expression features of C# in a C++ application, since Microsoft did port regex to VC++.

  • Loading, Please Wait ...

  • You must have javascript enabled in order to post comments.

Leave a Comment
  • Your email address will not be published. All fields are required.

Most Popular Programming Stories

More for Developers

RSS Feeds

Thanks for your registration, follow us on our social networks to keep up-to-date