建立和使用 C# DLL

HOW TO：建立和使用 C# DLL (C# 程式設計手冊)

Visual Studio 2008

其他版本

更新：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 中的方法來計算執行階段引數的總和與乘積。

範例

---

VB

C#

C++

F#

JScript

// File: Add.cs 
namespace UtilityMethods
{
    public class AddClass 
    {
        public static long Add(long i, long j) 
        { 
            return (i + j);
        }
    }
}

VB

C#

C++

F#

JScript

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

VB

C#

C++

F#

JScript

// 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  ");
            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        
*/

這個檔案包含了使用 Add 和 Multiply 等 DLL 方法的演算法。首先，它會剖析從命令列輸入的引數 num1 和 num2，然後再使用 AddClass 類別中的 Add 方法計算總和，並使用 MultiplyClass 類別上的 Multiply 方法計算乘積。

請注意，檔案開頭的 using 指示詞可以讓您使用名稱不符的類別名稱，在編譯時期參考 DLL 方法，如下所示：

VB

C#

C++

F#

JScript

MultiplyClass.Multiply(num1, num2);

否則，您必須使用完整名稱，如下所示：

VB

C#

C++

F#

JScript

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)。這個編譯器選項是選擇性的。此處的 /reference 編譯器選項會指定此程式所使用的 DLL 檔案。