如何:创建和使用 C# DLL(C# 编程指南)

更新:2007 年 11 月

动态链接库 (DLL) 在运行时链接到程序。为说明如何生成和使用 DLL,请看以下方案:

  • MathLibrary.DLL:为库文件,其中包含运行时要调用的方法。此例中,DLL 包含两个方法:Add 和 Multiply。

  • Add.cs:为源文件,其中包含 Add(long i, long j) 方法。该方法返回参数之和。包含 Add 方法的 AddClass 类是命名空间 UtilityMethods 的成员。

  • Mult.cs:为源文件,其中包含 Multiply(long x, long y) 方法。该方法返回参数之积。包含 Multiply 方法的 MultiplyClass 类也是命名空间 UtilityMethods 的成员。

  • TestCode.cs:包含 Main 方法的文件。它使用 DLL 文件中的方法来计算运行时参数的和与积。

示例

// File: Add.cs 
namespace UtilityMethods
{
    public class AddClass 
    {
        public static long Add(long i, long j) 
        { 
            return (i + j);
        }
    }
}
// File: Mult.cs
namespace UtilityMethods 
{
    public class MultiplyClass
    {
        public static long Multiply(long x, long y) 
        {
            return (x * y); 
        }
    }
}
// File: TestCode.cs

using UtilityMethods;

class TestCode
{
    static void Main(string[] args) 
    {
        System.Console.WriteLine("Calling methods from MathLibrary.DLL:");

        if (args.Length != 2)
        {
            System.Console.WriteLine("Usage: TestCode <num1> <num2>");
            return;
        }

        long num1 = long.Parse(args[0]);
        long num2 = long.Parse(args[1]);

        long sum = AddClass.Add(num1, num2);
        long product = MultiplyClass.Multiply(num1, num2);

        System.Console.WriteLine("{0} + {1} = {2}", num1, num2, sum);
        System.Console.WriteLine("{0} * {1} = {2}", num1, num2, product);
    }
}
/* Output (assuming 1234 and 5678 are entered as command line args):
    Calling methods from MathLibrary.DLL:
    1234 + 5678 = 6912
    1234 * 5678 = 7006652        
*/

此文件包含使用 DLL 方法 Add 和 Multiply 的算法。它首先分析从命令行输入的参数 num1 和 num2。然后使用 AddClass 类中的 Add 方法计算和,使用 MultiplyClass 类中的 Multiply 方法计算积。

请注意,文件开头的 using 指令使您得以在编译时使用未限定的类名来引用 DLL 方法,如下所示:

MultiplyClass.Multiply(num1, num2);

否则,必须使用完全限定名,如下所示:

UtilityMethods.MultiplyClass.Multiply(num1, num2);

执行

若要运行程序,请输入 EXE 文件的名称,文件名的后面跟两个数字,如下所示:

TestCode 1234 5678

编译代码

若要生成文件 MathLibrary.DLL,请使用以下命令行编译文件 Add.cs 和文件 Mult.cs:

csc /target:library /out:MathLibrary.DLL Add.cs Mult.cs

/target:library 编译器选项通知编译器输出 DLL 文件而不是 EXE 文件。后跟文件名的 /out 编译器选项用于指定 DLL 文件名。否则,编译器使用第一个文件 (Add.cs) 作为 DLL 文件名。

若要生成可执行文件 TestCode.exe,请使用以下命令行:

csc /out:TestCode.exe /reference:MathLibrary.DLL TestCode.cs

/out 编译器选项通知编译器输出 EXE 文件并且指定输出文件名 (TestCode.exe)。此编译器选项是可选的。/引用编译器选项指定该程序使用的 DLL 文件。

请参见

任务

如何:为 DLL 指定基址

概念

C# 编程指南

创建用于容纳 DLL 函数的类