Change Case コンポーネント サンプル

  • [アーティクル]

Change Case コンポーネント サンプルは、同期出力を持つ変換コンポーネントを示します。このコンポーネントは、行がコンポーネントを通過する時に、指定された列で 1 文字変更することによって、文字列の文字の大文字/小文字の変更を行います。コンポーネントのユーザーが列の文字および実行する変換の種類を指定できるようにするため、コンポーネントは、2 つのカスタム プロパティを、コンポーネントに対して選択された各列の入力列に追加します。これらのプロパティは、列のどの文字を変更するかと、大文字と小文字のどちらに変更するかを指定します。

このサンプルは、データ フロー コンポーネントのエラー出力の実装方法も示します。ユーザーがエラー出力に行をリダイレクトするように指定している場合、コンポーネントは、変更する文字のインデックスが文字列の長さを超えた時にそのエラー出力へ行を直接出力します。このサンプルは、Itanium ベースのオペレーティング システムではサポートされていません。

ms160910.note(ja-jp,SQL.90).gif重要 :
Integration Services の Data Flow Programming コード サンプルは、カスタム データ フロー コンポーネントを作成するために実装する必要のあるコア機能を示しています。サンプルは、[詳細エディタ] でのカスタマイズを完全にはサポートしていません。たとえば、[詳細エディタ] を使用して、入出力値の追加や削除、または列の構成を行うことはできません。 サンプルは、学習に使用することのみを目的に提供されています。これらは、運用環境での使用を目的としたものではなく、運用環境でのテストも実施されていません。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 ディレクトリにあります。

サンプルをインストールするために必要な 2 つの手順の詳細については、「サンプルのインストール」を参照してください。SQL Server 2005 のオリジナル リリース後にリリースされた新しいサンプルを含む、サンプルの最新バージョンを入手するには、「SQL Server 2005 Samples and Sample Databases (April 2006)」を参照してください。

サンプルのビルド

まだ Samples フォルダに厳密な名前のキー ファイルを生成していない場合は、次の手順に従ってこのキー ファイルを生成します。サンプル プロジェクトは、ビルド時にこのキー ファイルを使用してアセンブリに署名するように構成されています。署名プロパティは、[プロジェクトのプロパティ] ダイアログ ボックスの [署名] タブで表示できます。

厳密な名前のキー ファイルを生成するには

  1. Microsoft Visual Studio 2005 コマンド プロンプトを開くには、[スタート] ボタンをクリックして、[すべてのプログラム]、[Microsoft Visual Studio 2005]、[Visual Studio Tools] の順にポイントし、[Visual Studio 2005 コマンド プロンプト] をクリックします。

    または

    Microsoft .NET Framework コマンド プロンプトを開くには、[スタート] ボタンをクリックして、[すべてのプログラム]、[Microsoft .NET Framework SDK v2.0] の順にポイントし、[SDK コマンド プロンプト] をクリックします。

  2. コマンド プロンプトでディレクトリ変更 (CD) コマンドを使用して、コマンド プロンプト ウィンドウの現在のフォルダを Samples フォルダに変更します。このフォルダに作成するキー ファイルは、すべての SQL Server 2005 サンプル コードで使用されます。

    ms160910.note(ja-jp,SQL.90).gifメモ :
    サンプルが配置されているフォルダを確認するには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server 2005]、[マニュアルとチュートリアル] の順にポイントして、[サンプル ディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\90\Samples にあります。

  3. コマンド プロンプトで、次のコマンドを実行してキー ファイルを生成します。

    sn -k SampleKey.snk
    ms160910.note(ja-jp,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 "

    または

    次のコマンドを入力して 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. コンポーネントの隣にあるチェック ボックスをオンにして、[OK] をクリックします。

    ms160910.note(ja-jp,SQL.90).gifメモ :
    コンポーネントが一覧に表示されない場合は、[参照] をクリックして、コンポーネントを探すことができます。ただし、この場合は、コンポーネントが正しくインストールされていない可能性があります。

これらの手順を完了すると、コンポーネントは [ツールボックス] の [データ フロー変換] セクションに表示され、デザイナのデータ フロー タスクに追加することができます。

サンプルのテスト

コンポーネントがパッケージのデータ フロー タスクに追加され、そのコンポーネントに行を提供するコンポーネントに接続された後、次のように SSIS デザイナでコンポーネントを構成できます。

パッケージ内のサンプル コンポーネントを構成するには

  1. [詳細エディタ] の [入力列] タブをクリックして、コンポーネントが変更を行う列を選択します。着信データの各行を処理する際、コンポーネントはその場で列の値を変更するため、選択した列の使用方法の種類を読み取り/書き込みに設定する必要があります。

  2. [詳細エディタ] の [列のプロパティ] タブをクリックして、変更される各入力列で変更する、0 から始まる文字インデックスを指定し、そのインデックスの文字を大文字 (0) と小文字 (1) のどちらに変更するかを指定します。