创建和使用托管程序集 (C++)

项目
08/18/2008

更新：2007 年 11 月

我们将创建的下一个库类型是托管程序集。使用托管程序集是一种重用代码的绝佳方式。您不必在自己创建的每个程序中重新实现同一例程，而只需对这些例程编写一次，然后从需要该功能的应用程序引用它们即可。

本演练涵盖以下内容：

创建新的类库项目。
向该类库添加类。
创建引用该类库的应用程序。
在控制台应用程序中使用类库的功能。
运行应用程序。

先决条件

本主题假定您具备 C++ 语言的基础知识。

创建新的类库项目

从“文件”菜单中，选择“新建”，然后选择“项目”。
在“项目类型”窗格中，选择“Visual C++”下的“CLR”。这将创建一个面向公共语言运行库的项目。
在“模板”窗格中，选择“类库”。
为项目选择一个名称，如“MathFuncsAssembly”，并将其键入“名称”字段。为解决方案选择一个名称，如“ManagedAssemblies”，并将其键入“解决方案名称”字段。
按“确定”创建项目。
默认情况下，创建新项目时，会将它们设置为使用预编译头。若要禁用预编译头，请在“项目”菜单中选择“属性”。依次展开“配置属性”节点和“C/C++”节点，然后选择“预编译头”。从“创建/使用预编译头”旁边的下拉列表中，选择“不使用预编译头”。按“确定”保存这些更改。有关预编译头的更多信息，请参见创建预编译头文件。

向类库添加类

创建新的 CLR 类库后，向导将为您生成一个简单的类。头文件和源文件的名称与您以前为项目选择的名称相同。在本示例中，它们的名称为“MathFuncsAssembly.h”和“MathFuncsAssembly.cpp”。

使用名为“MyMathFuncsAssembly”的简单类替换“MathFuncsAssembly.h”中的现有代码，以执行常见的算术运算，如加、减、乘和除。代码应与以下内容类似：

// 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);
    };
}

在源文件中实现“MyMathFuncs”的功能。代码应与以下内容类似：

// 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;
    }
}

编译该类库，方法是选择“生成”菜单中的“生成解决方案”。这将创建一个可供其他程序使用的动态链接库 (DLL)。有关 DLL 的更多信息，请参见 DLL。

创建引用类库的应用程序

若要创建引用并使用您刚刚创建的类库的应用程序，请从“文件”菜单中选择“新建”，然后选择“项目...”。
在“项目类型”窗格中，选择“Visual C++”下的“CLR”。这将创建一个面向公共语言运行库的项目。
在“模板”窗格中，选择“CLR 控制台应用程序”。
为项目选择一个名称，如“MyExecRefsAssembly”，并将其键入“名称”字段。从“解决方案”旁边的下拉列表中选择“添入解决方案”。这会将新的项目添加到该类库所属的同一个解决方案中。
按“确定”创建项目。
默认情况下，创建新项目时，会将它们设置为使用预编译头。若要禁用预编译头，请在“项目”菜单中选择“属性”。依次展开“配置属性”节点和“C/C++”节点，然后选择“预编译头”。从“创建/使用预编译头”旁边的下拉列表中，选择“不使用预编译头”。按“确定”保存这些更改。有关预编译头的更多信息，请参见创建预编译头文件。

在控制台应用程序中使用类库的功能

创建新的 CLR 控制台应用程序后，将为您创建一个仅向控制台写入“Hello World”的程序。源文件的名称与在您前面为项目选择的名称相同。在本示例中，名称为“MyExecRefsAssembly.cpp”。
若要使用在类库中创建的算术例程，必须引用类库。为此，请选择“项目”菜单中的“引用…”。在“属性页”对话框中，展开“公用属性”节点，选择“引用”，然后选择“添加新引用...”按钮。有关“引用...”对话框的更多信息，请参见“<Projectname> 属性页”对话框 ->“通用属性”->“框架和引用”。

将显示“添加引用”对话框。此对话框列出了所有可以引用的库。“.NET”选项卡列出了 .NET Framework 附带的库。“COM”选项卡列出了计算机上的所有 COM 组件。“项目”选项卡列出了当前解决方案中的所有项目，以及它们包含的所有库。在“项目”选项卡上，选择“MathFuncsAssembly”，然后单击“确定”。有关“添加引用”对话框的更多信息，请参见“添加引用”对话框。

说明：
您可以通过包括 #using 指令直接从源文件引用程序集，如 #using <MathFuncsAssembly.dll> 中所示。有关此指令的更多信息，请参见 The #using Directive。

现在，可以在应用程序中使用“MyMathFuncs”类了。在“MyExecRefsAssembly.cpp”中，用下面的代码替换文件函数的内容：

// 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;
}

通过从“生成”菜单中选择“生成解决方案”，生成可执行文件。

运行应用程序

确保选择“MyExecRefsAssembly”作为默认项目。从“解决方案资源管理器”中，选择“MyExecRefsAssembly”，然后选择“项目”菜单中的“设为启动项目”。
若要运行项目，请选择“调试”菜单中的“开始执行（不调试）”。输出应如下所示：
```
a + b = 106.4
a - b = -91.6
a * b = 732.6
a / b = 0.0747474747474748
```