HOW TO：建立和使用 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
*/
這個檔案包含了使用 Add 和 Multiply 等 DLL 方法的演算法。首先，它會剖析從命令列輸入的引數 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)。這個編譯器選項是選擇性的。此處的 /reference 編譯器選項會指定此程式所使用的 DLL 檔案。