Walkthrough: Creating and Using a Managed Assembly 

From the File menu, select New and then select Project….

From the Project types pane, under Visual C++, select CLR. This creates a project that targets the Common Language Runtime.

From the Templates pane, select Class Library.

Choose a name for the project, such as MathFuncsAssembly, and enter it in the Name field. Choose a name for the solution, such as ManagedAssemblies, and enter it in the Solution Name field.

Press OK to create the project.

By default, when new projects are created, they are set up to use precompiled headers. To disable precompiled header, select Properties from the Project menu. Expand the Configuration Properties node, then expand the C/C++ node, and select Precompiled Headers. From the dropdown list next to Create/Use Precompiled Header, select Not Using Precompiled Header. Press OK to save these changes. For more information on precompiled headers, see Creating Precompiled Header Files.

After you create a new CLR Class Library, a simple class is created for you. The names for the header file and source file will be the same as the name you chose for the project above. In this example, they are named MathFuncsAssembly.h and MathFuncsAssembly.cpp.

Replace the existing code in MathFuncsAssembly.h with a simple class named MyMathFuncsAssembly to do common mathematical operations, such as addition, subtraction, multiplication, and division. The code should resemble the following:

// MathFuncsAssembly.h

using namespace System;

namespace MathFuncs
{
    public ref class MyMathFuncs
    {
    public:
        // Returns a + b
        static double Add(double a, double b);

        // Returns a - b
        static double Subtract(double a, double b);

        // Returns a * b
        static double Multiply(double a, double b);

        // Returns a / b
        // Throws DivideByZeroException if b is 0
        static double Divide(double a, double b);
    };
}

Implement the functionality for MyMathFuncs in the source file. The code should resemble the following:

// MathFuncsAssembly.cpp
// compile with: /clr /LD

#include "MathFuncsAssembly.h"

namespace MathFuncs
{
    double MyMathFuncs::Add(double a, double b)
    {
        return a + b;
    }

    double MyMathFuncs::Subtract(double a, double b)
    {
        return a - b;
    }

    double MyMathFuncs::Multiply(double a, double b)
    {
        return a * b;
    }

    double MyMathFuncs::Divide(double a, double b)
    {
        if (b == 0)
        {
            throw gcnew DivideByZeroException("b cannot be zero!");
        }

        return a / b;
    }
}

Compile the class library by selecting Build Solution from the Build menu. This creates a dynamic link library (DLL) that can be used by other programs. For more information on DLLs, see DLLs.

To create an application that will reference and use the class library that was just created, from the File menu, select New and then select Project….

From the Project types pane, under Visual C++, select CLR. This creates a project that targets the Common Language Runtime.

From the Templates pane, select CLR Console Application.

Choose a name for the project, such as MyExecRefsAssembly, and enter it in the Name field. Next to Solution, select Add to Solution from the drop down list. This will add the new project to the same solution as the class library.

Press OK to create the project.

By default, when new projects are created, they are set up to use precompiled headers. To disable precompiled header, select Properties from the Project menu. Expand the Configuration Properties node, then expand the C/C++ node, and select Precompiled Headers. From the dropdown list next to Create/Use Precompiled Header, select Not Using Precompiled Header. Press OK to save these changes. For more information on precompiled headers, see Creating Precompiled Header Files.

After you create a new CLR Console Application, a program is created for you that simply writes "Hello World" to the console. The name for the source file will be the same as the name you chose for the project above. In this example, it is named MyExecRefsAssembly.cpp.

To use the math routines that were created in the class library, you must reference it. To do this, select References… from the Project menu. From the Property Pages dialog, expand the Common Properties node and select References. Then select the Add New Reference… button. For more information on the References… dialog, see References, Common Properties, <Projectname> Property Pages Dialog Box.

The Add Reference dialog is displayed. This dialog lists all the libraries that you can reference. The .NET tab lists the libraries that are included with the .NET Framework. The COM tab lists all the COM components on your computer. The Project tab lists all the projects in the current solution and any libraries they contain. From the Projects tab, select MathFuncsAssembly. Then select OK. For more information on the Add Reference dialog, see Add Reference Dialog Box.

Note
You can also reference an assembly directly from the source file by including the #using directive, as in #using <MathFuncsAssembly.dll>. For more information on this directive, see The #using Directive.

You can now use the MyMathFuncs class in this application. In MyExecRefsAssembly.cpp, replace the contents of the file function with the following code:

// MyExecRefsAssembly.cpp
// compile with: /clr /FUMathFuncsAssembly.dll

using namespace System;

int main(array<System::String ^> ^args)
{
    double a = 7.4;
    int b = 99;

    Console::WriteLine("a + b = {0}",
        MathFuncs::MyMathFuncs::Add(a, b));
    Console::WriteLine("a - b = {0}",
        MathFuncs::MyMathFuncs::Subtract(a, b));
    Console::WriteLine("a * b = {0}",
        MathFuncs::MyMathFuncs::Multiply(a, b));
    Console::WriteLine("a / b = {0}",
        MathFuncs::MyMathFuncs::Divide(a, b));

    return 0;
}

Build the executable by selecting Build Solution from the Build menu.

Make sure MyExecRefsAssembly is selected as the default project. From the Solution Explorer, select MyExecRefsAssembly, and then select Set As StartUp Project from the Project menu.

To run the project, select Start Without Debugging from the Debug menu. The output should look like this:

a + b = 106.4
a - b = -91.6
a * b = 732.6
a / b = 0.0747474747474748