Enterprise Library 2.0 Hands On Lab 翻譯（4）：日誌應用程式區塊（一）

練習 1：在應用程式中新增日誌記錄

示範向現有應用程式新增日誌與追蹤，透過配置工具設定 TraceListener。

步驟 1：開啟專案

開啟 EnoughPI.sln，預設路徑 C:\Program Files\Microsoft Enterprise Library January 2006\labs\cs\Logging\exercises\ex01\begin，編譯。

步驟 2：關於練習應用程式

執行應用程式，EnoughPI 計算 π 精度。在 NumericUpDown 輸入精度點擊 Calculate。

步驟 3：新增日誌

1. 專案 EnoughPI 加入參考：Microsoft.Practices.EnterpriseLibrary.Logging.dll



2. 開啟 Calc\Calculator.cs，加入命名空間：using Microsoft.Practices.EnterpriseLibrary.Logging;
3. 在 OnCalculated 方法記錄計算完成資訊：

protected void OnCalculated(CalculatedEventArgs args)
{
    LogEntry log = new LogEntry();
    log.Message = string.Format("Calculated PI to {0} digits", args.Digits);
    log.Categories.Add(Category.General);
    log.Priority = Priority.Normal;

    Logger.Write(log);

    if (Calculated != null)
        Calculated(this, args);
}

建立 LogEntry 設定參數，使用 Logger.Write() 靜態方法記錄至一或多個 TraceListener。使用常數 Category 與 Priority 而非硬編碼，定義於 EnoughPI.Logging.Constants.cs：

public struct Priority
{
    public const int Lowest = 0;
    public const int Low = 1;
    public const int Normal = 2;
    public const int High = 3;
    public const int Highest = 4;
}
public struct Category
{
    public const string General = "General";
    public const string Trace = "Trace";
}