隨風設計

本教程展示如何在 C# 中創建和使用庫。
教程

本教程演示如何使用必要的編譯器選項創建托管 DLL 文件，以及如何通過客戶程序使用該庫。

示例

本示例使用下列模塊：

• DLL 庫 (Functions.dll)，從以下源文件生成：

  Factorial.cs：計算并返回某數的階乘。

  DigitCounter.cs：計算所傳遞的字符串中的數字位數。

• 使用該 DLL 的客戶程序 (FunctionTest.exe)，從源文件 FunctionClient.cs 進行編譯。本程序顯示輸入參數的階乘。

生成庫

若要生成該庫，請將 Functions 作為當前目錄，并在命令提示處鍵入下列內容：

csc /target:library /out:Functions.dll Factorial.cs DigitCounter.cs

其中：

編譯客戶程序

若要編譯該程序，請將 FunctionTest 作為當前目錄，并在命令提示處鍵入下列內容：

copy ..\Functions\Functions.dll .
csc /out:FunctionTest.exe /R:Functions.DLL FunctionClient.cs 

其中：

這將創建可執行文件 FunctionTest.exe。

文件 1：Factorial.cs

以下代碼計算傳遞給此方法（與“庫”示例不同，請將此方法編譯到庫中）的整數的階乘。

// Factorial.cs
// compile with: /target:library
using System; 

// Declares a namespace. You need to package your libraries according
// to their namespace so the .NET runtime can correctly load the classes.
namespace Functions 
{ 
    public class Factorial 
    { 
// The "Calc" static method calculates the factorial value for the
// specified integer passed in:
        public static int Calc(int i) 
        { 
            return((i <= 1) ? 1 : (i * Calc(i-1))); 
        } 
    }
}

文件 2：DigitCounter.cs

以下代碼用于計算所傳遞的字符串中的數字字符個數：

// DigitCounter.cs
// compile with: /target:library /out:Functions.dll /reference:Factorial.dll
using System; 

// Declare the same namespace as the one in Factorial.cs. This simply 
// allows types to be added to the same namespace.
namespace Functions 
{
    public class DigitCount 
    {
        // The NumberOfDigits static method calculates the number of
        // digit characters in the passed string:
        public static int NumberOfDigits(string theString) 
        {
            int count = 0; 
            for ( int i = 0; i < theString.Length; i++ ) 
            {
                if ( Char.IsDigit(theString[i]) ) 
                {
                    count++; 
                }
            }
            return count;
        }
    }
}

文件 3：FunctionClient.cs

生成庫后，其他程序便可以使用該庫。下面的客戶程序使用該庫中定義的類。本程序的基本功能是獲得每個命令行參數，并嘗試計算每個參數的階乘值。

// FunctionClient.cs
// compile with: /reference:Functions.dll,Factorial.dll /out:FunctionTest.exe
// arguments: 3 5 10
using System; 
// The following using directive makes the types defined in the Functions
// namespace available in this compilation unit:
using Functions;
class FunctionClient 
{ 
    public static void Main(string[] args) 
    { 
        Console.WriteLine("Function Client"); 

        if ( args.Length == 0 ) 
        {
            Console.WriteLine("Usage: FunctionTest ... "); 
            return; 
        } 

        for ( int i = 0; i < args.Length; i++ ) 
        { 
            int num = Int32.Parse(args[i]); 
            Console.WriteLine(
               "The Digit Count for String [{0}] is [{1}]", 
               args[i], 
               // Invoke the NumberOfDigits static method in the
               // DigitCount class:
               DigitCount.NumberOfDigits(args[i])); 
            Console.WriteLine(
               "The Factorial for [{0}] is [{1}]", 
                num,
               // Invoke the Calc static method in the Factorial class:
                Factorial.Calc(num) ); 
        } 
    } 
}

輸出

命令行 FunctionTest 3 5 10 使用程序 FunctionTest 計算 3、5 和 10 這三個整數的階乘。它還顯示每個參數的數字位數。

運行后得到以下輸出：

    Function Client
    The Digit Count for String [3] is [1]
    The Factorial for [3] is [6]
    The Digit Count for String [5] is [1]
    The Factorial for [5] is [120]
    The Digit Count for String [10] is [2]
    The Factorial for [10] is [3628800]

注意???為運行客戶可執行文件 (FunctionTest.exe)，文件 Functions.DLL 必須位于當前目錄、某子目錄或“全局程序集緩存”中。有關更多信息，請參見全局程序集緩存。