ADO 來源元件範例

發行項
12/15/2008

「ADO 來源元件」範例示範如何實作可用作「資料流程」工作中之資料來源的來源元件。此元件使用 ADO.NET 連接管理員取得與資料庫的連接，並執行使用者提供的 SQL 陳述式。透過執行陳述式取得的資料列會加入「資料流程」工作提供給元件的 PipelineBuffer，隨後可供下游元件使用。以 Itanium 為基礎的作業系統不支援這個範例。

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

「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\Ado Source Component 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 2.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 中建立範例

在 [檔案] | [開啟] 功能表上，按一下 [專案]，並以您偏好的程式設計語言來開啟 AdoSource.sln 方案檔。
在 [建立] 功能表上，按一下 [建立 AdoSource] 來建立專案。

安裝範例

此範例提供有 Visual Basic 和 C# 兩個版本。為了區別各版範例的組件，輸出組件的名稱會附加 CS 或 VB。成功建立元件之後，請遵循這些步驟，在 Business Intelligence Development Studio 中使用元件。

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

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

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

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

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

開啟 [命令提示字元] 視窗。
輸入下列命令以執行 gacutil.exe，並將 C# 版元件安裝於 GAC：

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

- 或 -
輸入下列命令以執行 gacutil.exe，並將 Visual Basic 版元件安裝於 GAC：

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

若要將元件加入工具箱中

開啟 [Business Intelligence Development Studio]。
以滑鼠右鍵按一下工具箱，然後按一下 [選擇項目]。
在 [選擇工具箱項目] 對話方塊中，按一下 [SSIS 資料流程項目] 索引標籤。
按一下元件旁邊的核取方塊，然後按一下 [確定]。

附註：

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

附註：
如果元件未顯示在清單中，您可以按一下 [瀏覽] 來自行尋找元件。不過，在此狀況中，它可能未安裝正確。

在您完成這些步驟之後，便可在 [工具箱] 的 [資料流程來源] 區段中看見元件，並可將其加入設計師中的「資料流程」工作。

測試範例

將範例元件加入至封裝中的「資料流程」工作之後，就可以在 SSIS 設計師中進行設定，如下所示。

若要在封裝中設定範例元件

將 ADO.NET 連接管理員加入封裝並為 SQL Server 選取 Microsoft OLE DB 提供者。設定範例元件使用此連接管理員。
在 [進階編輯器] 的 [元件屬性] 頁面中，於 [自訂屬性] 下，透過輸入針對連接管理員所連接之資料庫中資料表或檢視的有效 SQL 查詢，設定元件的 SqlStatement 自訂屬性。

共用方式為