共用方式為

大小寫轉換元件範例

  • 發行項

此「變更大小寫」元件範例示範具有同步輸出的轉換元件。此元件會在資料列通過它時，藉由修改指定資料行中的單一字元來變更字串中字元的大小寫。為了讓元件使用者能夠指定資料行中的字元以及要執行的轉換類型，該元件會將兩個自訂屬性加入至為元件選取之每個資料行的輸入資料行。這些屬性指定資料行中要變更的字元，以及應將其變更為大寫還是小寫。

此範例也示範如何實作資料流程元件的錯誤輸出。如果使用者指定將資料列重新導向至錯誤輸出，則元件會在要變更之字元的索引超過字串長度時將資料列導向至錯誤輸出。以 Itanium 為基礎的作業系統不支援這個範例。

ms160910.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\ChangeCase 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 程式碼範例使用。

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

  3. 在命令提示字元中，執行下列其中一個命令來產生金鑰檔：

    sn -k SampleKey.snk
    ms160910.note(zh-tw,SQL.90).gif重要事項：
    如需有關強式名稱金鑰組的詳細資訊，請參閱 MSDN 中 .NET Development Center 中的＜Security Briefs: Strong Names and Security in the .NET Framework＞。

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

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

  2. 在 [建立] 功能表上，按一下 [建立 ChangeCase] 來建立專案。

安裝範例

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

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

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

  2. 將組件 (ChangeCaseCS.dll 或 ChangeCaseVB.dll) 複製到位於 %system%\Program Files\Microsoft SQL Server\90\DTS 的 PipelineComponents 資料夾。

若要透過拖曳組件的方式將元件安裝至全域組件快取 (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\ ChangeCaseCS.dll "

    - or -

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

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

若要將元件加入工具箱中

  1. 開啟 [Business Intelligence Development Studio]。

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

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

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

    ms160910.note(zh-tw,SQL.90).gif附註：
    如果元件未顯示在清單中，您可以按一下 [瀏覽] 來自行尋找元件。不過，在此狀況中，它可能未安裝正確。

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

測試範例

將元件加入封裝中的「資料流程」工作，並連接到將為其提供資料列的元件之後，您可以在 SSIS 設計師中對其進行下列設定。

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

  1. 按一下 [進階編輯器] 的 [輸入資料行] 索引標籤，並選取元件將修改的資料行。所選取之資料行的使用類型必須設定為讀取/寫入，因為當元件處理每個流入資料的資料列時會適當修改資料行值。

  2. 按一下 [進階編輯器] 的 [資料行屬性] 索引標籤，指定以零為基底的字元索引以在每個已修改的輸入資料行中進行修改，並指定該索引處的字元變更為大寫 (0) 還是小寫 (1)。