共用方式為


使用文字檔追蹤

本主題僅適用於 Windows Workflow Foundation 4。

這個範例示範如何建立自訂的追蹤參與者,以擴充 Windows Workflow Foundation (WF) 中的追蹤功能。追蹤參與者是可接收執行階段所發出之追蹤記錄的 .NET Framework 類別。您可以建立追蹤參與者,將追蹤事件傳輸至特定狀況所需的任何目的地。例如,ETW (Windows 事件追蹤) 追蹤參與者是在 .NET Framework 中提供的。這個範例中的追蹤參與者會將 XML 格式的記錄寫入至文字檔。

範例詳細資料

若要最佳化追蹤參與者的實用性和強固性,必須完成一些額外步驟,將追蹤參與者適當連接至執行階段。下表描述這個範例中建立以最佳作法編譯之追蹤參與者所用的類別。

類別 說明

TextFileTrackingExtensionElement

BehaviorExtensionElement 是用來定義用於設定文字檔追蹤參與者的組態區段。這可讓使用者使用標準 .NET Framework 組態檔來指定記錄檔的目的地。

TextFileTrackingBehavior

WCF 中的行為可讓使用者將延伸模組插入執行階段中。當服務啟動時,此行為會將追蹤參與者加入至服務。

TextFileTrackingParticipant

在執行階段,接收追蹤記錄並將其以 XML 格式儲存至記錄檔的追蹤參與者。

行為延伸項目組態

必須完成另一個步驟,才能透過 .NET Framework 組態檔來利用先前描述的行為延伸項目。下列組態必須放置在要使用此延伸模組的組態檔中。

<system.serviceModel>
    <extensions>
      <behaviorExtensions>
        <add name="textFileTracking" type="Microsoft.Samples.TextFileTracking.TextFileTrackingExtensionElement, WFStockPriceApplication, Version=1.0.0.0, Culture=neutral, PublicKeyToken=null" />
      </behaviorExtensions>
    </extensions>
…
  </system.serviceModel>
Ee667247.note(zh-tw,VS.100).gif注意:
如需行為延伸項目組態的完整範例使用方式,請參閱範例中的 Web.config 檔案。

自訂追蹤記錄

GetStockPrices.cs 檔案示範如何從 CodeActivity 中建立自訂追蹤記錄。在執行範例時請尋找此記錄。

若要使用這個範例

  1. 使用 Visual Studio 2010 開啟 WFStockPriceApplication.sln 方案檔案。

  2. 若要建立方案,請按下 F6。

  3. 若要執行方案,請按 CTRL+F5。

    瀏覽器視窗隨即開啟並顯示應用程式的目錄清單。

  4. 在瀏覽器中,按一下 StockPriceService.xamlx。

  5. 瀏覽器隨即顯示 StockPriceService 頁面,其中包含本機服務 wsdl 位址。複製此位址。

    本機服務 wsdl 位址的範例是 https://localhost:53797/StockPriceService.xamlx?wsdl。

  6. 使用 [Windows 檔案總管] 移至 Visual Studio 2010 資料夾 (預設安裝資料夾為 %SystemDrive%\Program Files\Microsoft Visual Studio 10.0)。然後尋找 Common7\IDE\ 子資料夾。

  7. 按兩下 WcfTestClient.exe 檔案以啟動 WCF 測試用戶端。

  8. 在 WCF 測試用戶端中,選取 [檔案] 功能表上的 [新增服務]。

  9. 將剛才複製的 URL 貼到文字方塊中。

  10. 按一下 [確定] 以關閉對話方塊。

  11. 使用 WCF 測試用戶端測試此服務。

    1. 在 WCF 測試用戶端中,按兩下 IStockPriceService 節點底下的 GetStockPrice()

      右窗格中隨即出現 GetStockPrice() 方法,其中有一個參數。

    2. 輸入 Contoso 做為參數值。

    3. 按一下 [叫用]。

  12. 查看位於應用程式目錄之記錄檔 (即 %APPDATA%\trackingRecords.log) 的追蹤事件。

    Ee667247.note(zh-tw,VS.100).gif注意:
    %APPDATA% 是環境變數,在 Windows Vista、Windows Server 2008 或 Windows Server 2008 中會解析為 %SystemDrive%\Users\<username>\AppData\Roaming。

Ee667247.Important(zh-tw,VS.100).gif 注意:
這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄,然後再繼續。

<InstallDrive>:\WF_WCF_Samples

如果此目錄不存在,請移至用於 .NET Framework 4 的 Windows Communication Foundation (WCF) 與 Windows Workflow Foundation (WF) 範例 (英文),以下載所有 Windows Communication Foundation (WCF) 和 WF 範例。此範例位於下列目錄。

<InstallDrive>:\WF_WCF_Samples\WF\Basic\Tracking\TextFileTracking