Array Parameter サンプル

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

更新 : 2006 年 4 月 14 日

データベース内の行のセットを作成、更新、または削除すると便利な場合があります。これを行うには、いくつかの方法があります。1 つは、共通言語ランタイム (CLR) 統合ユーザー定義データ型を使用して、情報の配列をクライアントからサーバー上の CLR 統合ストアドプロシージャへ渡す方法です。CLR 統合ユーザー定義データ型の性質によって、サーバーに提供されるデータの大きさは 8,000 バイトに制限されます。したがって、この方法は、大規模なデータや複雑なデータを扱う場合には適切ではありません。詳細については、AdventureWorks Cycles CLR レイヤサンプルの連絡先作成ストアドプロシージャを参照してください。操作するデータが小規模で単純な場合、この方法は、行ごとにストアドプロシージャを呼び出す方法よりもはるかに効率的です。データの順序が重要なアプリケーションでは、配列を渡すことでデータの順序を保持できます。

このサンプルの内容は次のとおりです。

ContactTypeNames ユーザー定義データ型。これには、目的の連絡先の型名のリストが含まれています。
Microsoft Visual C# メソッドまたは Microsoft Visual Basic メソッドとして実装された usp_EnsureContactTypeNames ストアドプロシージャ。このストアドプロシージャは、ContactTypeNames ユーザー定義データ型のインスタンスを受け取り、Person.ContactType テーブルにない連絡先名がこのユーザー定義データ型インスタンスに含まれている場合、新しい行をテーブルに挿入します。
TestArrayParameter コンソールアプリケーション。このアプリケーションは、渡されたコマンドラインパラメータに基づいて ContactTypeNames ユーザー定義データ型のインスタンスを作成し、usp_EnsureContactTypeNames ストアドプロシージャを呼び出して、このユーザー定義データ型インスタンスをパラメータとして渡します。

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

シナリオ

Jane は Adventure Works Cycles の開発者です。少数の単純な行をテーブルに挿入する必要がありますが、データベースの負荷を最小にする必要があります。

言語

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

機能

Array Parameter サンプルでは、Microsoft の次の機能を使用します。

アプリケーションエリア	機能
全体	CLR、ユーザー定義データ型、Transact-SQL

前提条件

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

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」を参照してください。