Readme_UDT サンプル

[このトピックはプレリリース版のドキュメントであり、今後のリリースでは変更される場合があります。空のトピックがプレースホルダーとして含まれています。ご注意 : マイクロソフトでは、より多くのコンテンツを日本語で提供できるよう、機械翻訳などの方法によってローカライズされたドキュメントを提供する場合があります。このプレリリース版の一部のコンテンツはそのような方法によってローカライズされたものです。私たちマイクロソフトは、このような方法でローカライズされたものが必ずしも最適ではなく、語彙、構文、文法における誤りを含む可能性を認識しています。このコンテンツの最終版は、従来の方法によるローカライズで行われ、その品質は旧版と同等のものになります。]

このサンプルは、SQL Server 2005 および SQL Server 2008 でのみ動作します。SQL Server 2005 より前のバージョンでは動作しません。

UserDefinedDataType サンプルでは、System.Data.SqlClient を使用して、Transact-SQL とクライアント アプリケーションの両方から単純なユーザー定義データ型の作成と使用を行う方法を示します。

既定のインストール ディレクトリは、C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\UserDefinedDataType です。

SQL Server のサンプルやサンプル データベースを表示したり使用したりするには、まずそれをダウンロードしてインストールする必要があります。詳細については、「SQL Server のサンプルとサンプル データベースのインストールに関する注意点」を参照してください。

シナリオ

開発者は、複素数の表示、保持、および操作を行う必要があります。

言語

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

機能

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

前提条件

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

• Microsoft SQL Server または Microsoft SQL Server Express。SQL Server Express は、SQL Server Express ドキュメントとサンプルの Web サイトから無償で入手できます。
• AdventureWorks2008R2 データベース。SQL Server デベロッパー Web サイトから入手できます。
• SQL Server データベース エンジン サンプル。SQL Server デベロッパー Web サイトから入手できます。
• .NET Framework SDK 2.0 または Microsoft Visual Studio 2005。.NET Framework SDK は無償で入手できます。「.NET Framework ドキュメントのインストール」を参照してください。

サンプルのビルド

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

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

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

   -- または --

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

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

   注意

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

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

   sn -k SampleKey.snk

   注意

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

サンプルをビルドするには、次の手順を行います。

サンプルのビルド

1. Visual Studio 2005 および提供されている Visual Studio ソリューションを使用するか、.NET Framework SDK 2.0 に含まれている Microsoft MSBuild を使用して、サンプルをコンパイルします。コマンド プロンプトで、次のようなコマンドを実行します。

   msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\ComplexNumber.sln

2. AdventureWorks2008R2 データベースがインストールされていることを確認します。必要に応じて、サンプルをインストールするデータベースを作成します。

3. Visual C# プロジェクトと Visual Basic プロジェクトのどちらをコンパイルしたかに応じて、SQL Server Management Studio でファイル scripts\installCS.sql または scripts\installVB.sql を開きます。ファイルに含まれているスクリプトを実行するか、コマンド プロンプトで次のコマンドを実行します。

   sqlcmd -E -I -i Scripts\InstallCS.sql

   このファイルには、SQL Server で CLR 統合 UDT サンプルのインストールと登録を行うためのスクリプトが含まれています。

サンプルの実行

このサンプルを実行するには、次の手順を行います。

サンプルの実行

1. SQL Server Management Studio で scripts\test.sql ファイルを開き、ファイルに含まれているスクリプトを実行します。または、コマンド プロンプトで次のコマンドを実行します。

   sqlcmd -E -I -i Scripts\test.sql

   このスクリプトにより、Transact-SQL からサンプルの CLR 統合 UDT オブジェクトが呼び出されます。

2. コマンド ラインで、サンプルのユーザー定義データ型がインストールされたデータベースの名前を指定して、clientsample.exe を実行します。この簡単なコンソール アプリケーションでは、System.Data.SqlClient を使用してサンプルのユーザー定義データ型が呼び出されます。

サンプルの削除

このサンプルを削除するには、次の手順を行います。

サンプルの削除

1. SQL Server Management Studio で scripts\cleanup.sql ファイルを開き、ファイルに含まれているスクリプトを実行します。または、コマンド プロンプトで次のコマンドを実行します。

   sqlcmd -E -I -i Scripts\cleanup.sql

   このスクリプトにより UDT サンプルが削除されます。

備考

このサンプルを正しく機能させるには、SQL Server または SQL Server Express の CLR を有効にする必要があります。

サンプルは、演習目的で利用するためにのみ提供されています。サンプルを運用環境で使用することは想定されていないため、運用環境でのサンプルのテストは行われていません。Microsoft では、これらのサンプルに関する製品サポート サービスを提供していません。システム管理者の承認を得ることなく、サンプル アプリケーションやサンプル アセンブリを、運用中の SQL Server データベースやレポート サーバーに接続したり、これらのデータと共に使用することは避けてください。

参照

概念

CLR プログラミング サンプル

ヘルプおよび情報

SQL Server 2008 R2 の参考資料の入手