HtmlLogProvider 範例

發行項
12/15/2008

新增： 2006 年 4 月 14 日

HtmlLogProvider 範例示範如何建立自訂記錄提供者「Html 記錄提供者」，該提供者會將記錄輸出寫入 HTML 文件。

如需有關如何建立自訂記錄提供者的詳細資訊，請參閱＜Creating a Custom Log Provider＞。如需有關在 Integration Services 中使用記錄提供者的一般資訊，請參閱＜Integration Services 記錄提供者＞。

自訂記錄提供者會從現有的檔案連接管理員取得副檔名為 .htm 或 .html 的目的地檔案名稱。它會將記錄的事件輸出到指定目的地檔案的 HTML 資料表中，並忽略最後兩個標準欄位 (dataCode 和 dataBytes)，這兩個欄位可能包含無法在 HTML 文件中正確顯示的二進位資料。此範例會將 HTML 記錄程式碼封裝在個別的 HtmlLogWriter Helper 類別中，以方便重複使用。此 Helper 類別具有 OpenLogHtml、LogHtml 和 CloseLogHtml 副程式，這些副程式分別從 OpenLog、Log 和 CloseLog 呼叫。以 Itanium 為基礎的作業系統不支援這個範例。

此程式碼範例實作下列功能：

LogProviderBase 類別的置換。
預設的持續性支援，開發人員不必撰寫自訂的持續性程式碼。

重要事項：
範例只供教育目的之用。它們不能用於實際執行環境，而且從來沒有在實際執行環境中測試過。Microsoft 不提供對這些範例的技術支援。

執行範例

如果您已經知道如何找出、建置和安裝程式碼範例，可以直接跳至＜測試範例＞一節，閱讀有關如何設定與執行程式碼範例的內容。

必要條件

此範例需要安裝下列元件。

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

位置

如果程式碼範例安裝於預設位置，則範例位於下列目錄中：

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\HtmlLogProvider Sample

程式碼範例的 C# 方案位於 CS 目錄中，而 Visual Basic 方案位於 VB 目錄中。

如需有關安裝範例所需執行之兩個步驟程序的詳細資訊，請參閱＜安裝範例＞。若要取得最新版的範例，包括自 SQL Server 2005 原始發行版本以來所發佈的新範例，請參閱＜SQL Server 2005 範例與範例資料庫 (2006 年 4 月)＞(英文)。

建立範例

如果您尚未在 Samples 資料夾產生強式名稱金鑰檔，請使用下列程序來產生此金鑰檔。範例專案在 [專案屬性] 對話方塊的 [簽章] 索引標籤上設定為在建立時期以此金鑰檔簽署組件。

若要產生強式名稱金鑰檔

若要開啟 Microsoft Visual Studio 2005 命令提示字元，請按一下 [開始]，依序指向 [所有程式]、[Microsoft Visual Studio 2005]、[Visual Studio 工具]，然後按一下 [Visual Studio 2005 命令提示字元]。

- 或 -

若要開啟 Microsoft .NET Framework 命令提示字元，請按一下 [開始]，依序指向 [所有程式] 和 [Microsoft .NET Framework SDK v2.0]，然後按一下 [SDK 命令提示字元]。

在命令提示字元中，使用變更目錄 (CD) 命令，將命令提示字元的現行資料夾變更為 Samples 資料夾。您在此資料夾建立的金鑰檔將供所有 SQL Server 2005 程式碼範例使用。

附註：
若要判斷範例所在的資料夾，按一下 [開始]，依序指向 [所有程式]、[Microsoft SQL Server 2005] 和 [文件集和教學課程]，然後按一下 [範例目錄]。如果是使用預設安裝位置，則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples。

在命令提示字元中，執行下列其中一個命令來產生金鑰檔：
```
sn -k SampleKey.snk
```
重要事項：

如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

重要事項：
如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

若要在 Microsoft Visual Studio 2005 中建立範例

從 [檔案] | [開啟] 功能表，按一下 [專案] 並開啟 [HtmlLogProviderVB.sln] 或 [HtmlLogProviderCS.sln]。
在 [建立] 功能表上，按一下 [建置方案] 來建立方案。

安裝範例

此範例提供有 Visual Basic 和 C# 兩個版本。為了區別各版範例的組件，輸出組件的名稱會附加 CS 或 VB。成功建立元件之後，請遵循這些步驟，將它加入 Business Intelligence Development Studio 中，作為封裝中的連接管理員。

若要將元件複製到 Connections 資料夾

開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。
將組件 (HtmlLogProviderCS.dll 或 HtmlLogProviderVB.dll) 複製到位於 %system%\Program Files\Microsoft SQL Server\90\DTS 的 LogProviders 資料夾。

若要透過拖放組件將元件安裝於全域組件快取 (GAC)

開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。
將組件從 LogProviders 資料夾拖曳到全域組件快取 (GAC) 所在的資料夾中，即 %system%\assembly。

若要使用 gacutil.exe 將元件安裝於全域組件快取 (GAC)

開啟 [命令提示字元] 視窗。

輸入下列命令，將元件的 C# 版本安裝到 GAC：

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\HtmlLogProvider Sample\CS\HtmlLogProviderCS\bin\Debug\HtmlLogProviderCS.dll"

- 或 -

輸入下列命令，將元件的 Visual Basic 版本安裝至 GAC：

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\HtmlLogProvider Sample\VB\HtmlLogProviderVB\bin\Debug\HtmlLogProviderVB.dll"

測試範例

您現在可以在封裝中測試自訂記錄提供者。

若要在封裝中使用範例記錄提供者

在 Integration Services 專案中，加入新的檔案連接管理員，並將它設定為指向副檔名為 **.**htm 或 **.**html 的檔案。
從 [SSIS] 功能表選取 [記錄]，然後加入 HTML 檔案的自訂記錄提供者 (CS) 或 HTML 檔案的自訂記錄提供者 (VB)。
在 [組態] 欄位中，輸入檔案連接管理員的名稱。
適當設定記錄，讓封裝和其元件將其事件記錄到自訂記錄提供者。
執行封裝，然後開啟 HTML 檔案，檢視記錄輸出。

共用方式為