使用文字檔追蹤
本主題僅適用於 Windows Workflow Foundation 4。
這個範例示範如何建立自訂的追蹤參與者,以擴充 Windows Workflow Foundation (WF) 中的追蹤功能。追蹤參與者是可接收執行階段所發出之追蹤記錄的 .NET Framework 類別。您可以建立追蹤參與者,將追蹤事件傳輸至特定狀況所需的任何目的地。例如,ETW (Windows 事件追蹤) 追蹤參與者是在 .NET Framework 中提供的。這個範例中的追蹤參與者會將 XML 格式的記錄寫入至文字檔。
範例詳細資料
若要最佳化追蹤參與者的實用性和強固性,必須完成一些額外步驟,將追蹤參與者適當連接至執行階段。下表描述這個範例中建立以最佳作法編譯之追蹤參與者所用的類別。
類別 | 說明 |
---|---|
|
BehaviorExtensionElement 是用來定義用於設定文字檔追蹤參與者的組態區段。這可讓使用者使用標準 .NET Framework 組態檔來指定記錄檔的目的地。 |
|
WCF 中的行為可讓使用者將延伸模組插入執行階段中。當服務啟動時,此行為會將追蹤參與者加入至服務。 |
|
在執行階段,接收追蹤記錄並將其以 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>
注意: |
---|
如需行為延伸項目組態的完整範例使用方式,請參閱範例中的 Web.config 檔案。 |
自訂追蹤記錄
GetStockPrices.cs 檔案示範如何從 CodeActivity 中建立自訂追蹤記錄。在執行範例時請尋找此記錄。
若要使用這個範例
使用 Visual Studio 2010 開啟 WFStockPriceApplication.sln 方案檔案。
若要建立方案,請按下 F6。
若要執行方案,請按 CTRL+F5。
瀏覽器視窗隨即開啟並顯示應用程式的目錄清單。
在瀏覽器中,按一下 StockPriceService.xamlx。
瀏覽器隨即顯示 StockPriceService 頁面,其中包含本機服務 wsdl 位址。複製此位址。
本機服務 wsdl 位址的範例是 https://localhost:53797/StockPriceService.xamlx?wsdl。
使用 [Windows 檔案總管] 移至 Visual Studio 2010 資料夾 (預設安裝資料夾為 %SystemDrive%\Program Files\Microsoft Visual Studio 10.0)。然後尋找 Common7\IDE\ 子資料夾。
按兩下 WcfTestClient.exe 檔案以啟動 WCF 測試用戶端。
在 WCF 測試用戶端中,選取 [檔案] 功能表上的 [新增服務]。
將剛才複製的 URL 貼到文字方塊中。
按一下 [確定] 以關閉對話方塊。
使用 WCF 測試用戶端測試此服務。
在 WCF 測試用戶端中,按兩下 IStockPriceService 節點底下的 GetStockPrice()。
右窗格中隨即出現 GetStockPrice() 方法,其中有一個參數。
輸入 Contoso 做為參數值。
按一下 [叫用]。
查看位於應用程式目錄之記錄檔 (即 %APPDATA%\trackingRecords.log) 的追蹤事件。
注意: %APPDATA% 是環境變數,在 Windows Vista、Windows Server 2008 或 Windows Server 2008 中會解析為 %SystemDrive%\Users\<username>\AppData\Roaming。
注意: |
---|
這些範例可能已安裝在您的電腦上。請先檢查下列 (預設) 目錄,然後再繼續。
<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
|