Hello World Ready サンプル

[アーティクル]
12/15/2008

更新 : 2005 年 12 月 5 日

Hello World Ready サンプルでは、国際化対応の、CLR (共通言語ランタイム) 統合ベースの単純なストアドプロシージャの作成、展開、およびテストにかかわる基本的な操作を示しています。国際化対応コンポーネントは、コンポーネントのソースコードを変更することなく、世界中の市場に向けて、異なる言語へのローカライズを簡単に行うことができます。また、このサンプルでは、出力パラメータを使用してデータを返す方法、およびストアドプロシージャによって動的に構築されてクライアントに返されるレコードを使用してデータを返す方法についても示します。

このサンプルは、このアプリケーションのローカライズをより簡単かつ安全に行える点を除き、Hello World サンプルとほぼ同じです。ローカライズ済みテキストを変更するには、次の作業を実行する必要があります。

リソースディレクトリの特定のカルチャに合わせた XML ファイル (.resx ファイル) を変更します。
resgen を使用して、カルチャに応じたリソースファイルをビルドします。
そのカルチャに関して更新されたサテライト DLL をビルドします。
このアセンブリを SQL Server でいったん削除してから、追加します。

CLR ストアドプロシージャ自体のソースコードおよびアセンブリは変更されません。build.cmd スクリプトは、リソースアセンブリのコンパイル方法とリンク方法を示すリソースディレクトリに提供されています。

アプリケーションのソースコードによって、現在実行しているアセンブリに基づいたリソースマネージャが作成されますが、ストアドプロシージャを含む DLL にカルチャニュートラルリソースを埋め込む必要はありません。AssemblyInfo.cs ファイルまたは AssemblyInfo.vb ファイルで使用される System.Resources.NeutralResourcesLanguage 属性によって、カルチャニュートラルリソースがサテライト DLL に存在することが許可されます。この目的でそれぞれ別の DLL を使用すると、ローカライズ済みテキストの追加や変更が必要な場合でも、CLR ストアドプロシージャを含んでいるプライマリ DLL の変更が必要なくなるため非常に便利です。これは、型の削除と再追加を困難にするような列やその他の依存関係を含んでいることのある、CLR ユーザー定義型には特に役立ちます。

通常、サテライト DLL バージョンはメインアセンブリバージョンと同じである必要があります。ただし、SatelliteContractVersion 属性を使用して、サテライトアセンブリを更新せずにメインアセンブリの更新を許可することもできます。詳細については、Microsoft .NET Framework Version 2.0 SDK ドキュメントの ResourceManager クラスを参照してください。

インストールディレクトリは、drive:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\HelloWorldReady\ です。

シナリオ

Jane は Adventure Works Cycles の開発者です。CLR 統合ストアドプロシージャの使用に関する基本を理解する必要があります。また、所属するチームで使用するテクニックとなるリソースを使用して、国際化対応の CLR 統合ストアドプロシージャをどのように開発するかについても理解する必要があります。

言語

Transact-SQL、Visual C#、および Visual Basic。

機能

Hello World Ready サンプルは、SQL Server の次の機能を使用します。

アプリケーションエリア	機能
全体	CLR、メタデータ
ローカライズ	リソース

前提条件

このサンプルを実行する前に、次のソフトウェアがインストールされていることを確認してください。

Microsoft SQL Server 2005 または Microsoft SQL Server 2005 Express Edition (SQL Server Express)。SQL Server Express は、SQL Server 2005 Express Edition ドキュメントとサンプルの Web サイトから無償で入手できます。
SQL Server 2005 に付属の AdventureWorks データベース。SQL Server デベロッパー Web サイトからも入手できます。
SQL Server 2005 データベースエンジンのサンプル。これらのサンプルは SQL Server 2005 に含まれています。これらの最新バージョンは、SQL Server デベロッパー Web サイトからダウンロードできます。
.NET Framework SDK 2.0 または Microsoft Visual Studio 2005。.NET Framework SDK は無償で入手できます。詳細については、「.NET Framework SDK のインストール」を参照してください。

サンプルのビルド

強力な名前のキーファイルをまだ作成していない場合は、次の指示に従ってキーファイルを生成してください。

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

Microsoft Visual Studio 2005 コマンドプロンプトを開きます。[スタート] メニューの [すべてのプログラム] をポイントし、[Microsoft .NET Framework SDK 2.0] をポイントします。次に、[SDK コマンドプロンプト] をクリックします。

-- または --

Microsoft .NET Framework コマンドプロンプトを開きます。[スタート] メニューの [すべてのプログラム] をポイントし、[Microsoft .NET Framework SDK 2.0] をポイントします。次に、[SDK コマンドプロンプト] をクリックします。

ディレクトリの移動コマンド (CD) を使用して、コマンドプロンプトウィンドウの現在のディレクトリから、サンプルがインストールされているフォルダに移動します。

注 :
サンプルが配置されているフォルダを調べるには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server]、[マニュアルとチュートリアル] の順にポイントして、[サンプルディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\100\Samples にあります。

サンプルが配置されているフォルダを調べるには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server]、[マニュアルとチュートリアル] の順にポイントして、[サンプルディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\100\Samples にあります。

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

sn -k SampleKey.snk

重要 :
厳密な名前のキーペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。