共用方式為


DatasetDestination 元件範例

DatasetDestination 範例示範如何實作整合至 Business Intelligence Development Studio 並可加入至「資料流程」工作的自訂目的地元件。該元件會儲存其在資料集中執行期間所接收的資料列。在執行結束時,會依據元件的組態將資料集指派給執行階段的變數且可能還會被儲存至 XML 檔案。從資料集建立的 XML 檔可以用來做為「XML 來源」的 XML 來源。這項設計可將資料流程的執行結果儲存到外部,並且用來做為另一個元件的來源。以 Itanium 為基礎的作業系統不支援這個範例。

ms160922.note(zh-tw,SQL.90).gif重要事項:
「Integration Services 資料流程程式設計」程式碼範例示範實作所需的核心功能,以建立自訂資料流程元件。範例不包含對於在 [進階編輯器] 中進行自訂的完整支援。例如,您無法使用 [進階編輯器] 加入或移除輸入和輸出,或設定資料行。 範例只供教育目的之用。它們不能用於實際執行環境,而且從來沒有在實際執行環境中測試過。Microsoft 不提供這些範例的技術支援。

執行範例

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

必要條件

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

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

位置

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

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\DataSetDestination Component Sample\

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

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

建立範例

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

若要產生強式名稱金鑰檔

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

    - 或 -

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

  2. 在命令提示字元中,使用變更目錄 (CD) 命令,將 [命令提示字元] 視窗的目前資料夾變更為 Samples 資料夾。您在此資料夾建立的金鑰檔將供所有 SQL Server 2005 程式碼範例使用。

    ms160922.note(zh-tw,SQL.90).gif附註:
    若要判斷範例所在的資料夾,按一下 [開始],依序指向 [所有程式]、[Microsoft SQL Server 2005] 和 [文件集和教學課程],然後按一下 [範例目錄]。如果是使用預設安裝位置,則範例位於 <system_drive>:\Program Files\Microsoft SQL Server\90\Samples。
  3. 在命令提示字元中,執行下列其中一個命令來產生金鑰檔:

    sn -k SampleKey.snk
    
  4. 重要事項 如需有關強式名稱金鑰組的詳細資訊,請參閱 MSDN 中 .NET Development Center 中的<Security Briefs: Strong Names and Security in the .NET Framework>。

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

  1. [檔案] | [開啟] 功能表上,按一下 [專案],並以您偏好的程式設計語言來開啟 DataSetDestination.sl。

  2. [建立] 功能表上,按一下 [建立 DatasetDestination] 來建立專案。

安裝範例

此範例提供有 Visual Basic 和 C# 兩個版本。為了區別各版範例的組件,輸出組件的名稱會附加 CS 或 VB。成功建立元件之後,請遵循下列步驟將其加入 Business Intelligence Development Studio 中的「資料流程」工作。

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

  1. 開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。

  2. 將組件 (DatasetDestinationCS.dll 或 DatasetDestinationVB.dll) 複製到位於 %system%\Program Files\Microsoft SQL Server\90\DTSPipelineComponents 資料夾。

若要透過拖曳組件的方式將元件安裝至全域組件快取 (GAC)

  1. 開啟 [Windows 檔案總管] 或您偏好的應用程式來使用檔案系統。

  2. 將組件從 PipelineComponents 資料夾拖曳到全域組件快取 (GAC) 所在的資料夾,即 %system%\assembly

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

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

  2. 輸入下列命令以執行 gacutil.exe,並將 C# 版元件安裝於 GAC:

    gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationCS.dll "

    - or -

    輸入下列命令以執行 gacutil.exe,並將 Visual Basic 版元件安裝於 GAC:****

    gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationVB.dll "

若要將元件加入工具箱中

  1. 開啟 [Business Intelligence Development Studio]。

  2. 以滑鼠右鍵按一下工具箱,然後按一下 [選擇項目]

  3. [選擇工具箱項目] 對話方塊中,按一下 [SSIS 資料流程項目] 索引標籤。

  4. 按一下元件旁邊的核取方塊,然後按一下 [確定]

  5. 注意:如果元件未顯示在清單中,您可以按一下 [瀏覽] 來自行尋找元件。不過,在此狀況中,它可能未安裝正確。

完成這些步驟後,元件會顯示在 [工具箱][資料流程項目] 索引標籤中,並可加入至「SSIS 設計師」中的「資料流程」工作。

測試範例

將範例元件加入至封裝中的「資料流程」工作之後,就可以在 SSIS 設計師中進行設定。「DataSet 目的地」元件有三個控制其執行行為的自訂屬性。如果您保留這些屬性的預設值,元件會成功執行。在此狀況中,資料集不會在執行結束時儲存起來。

屬性 描述

RuntimeVariable

指定執行後要將資料集寫入到之執行階段變數的名稱。

DataTableName

指定建立 (用於新資料集) 或附加 (用於現有資料集) 的 DataTable 名稱。

SaveDataSetToXml

指定是否在執行結束時將資料集儲存至 XML 檔案。若為 true,則必須為元件指定「檔案」連接管理員。