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 中的方法來計算執行階段引數的總和與乘積。
// 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 方法,如下所示:
否則,您必須使用完整名稱,如下所示:
執行
若要執行此程式,請輸入 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 檔案。