チュートリアル : LINQ to SQL クラスの作成 (O/R デザイナ)

[アーティクル]
09/17/2008

更新 : November 2007

オブジェクトリレーショナルデザイナ (O/R デザイナ) は、データベース内のオブジェクトに基づく LINQ to SQL クラス (エンティティクラス) を作成および編集するためのビジュアルデザインサーフェイスを提供します。LINQ to SQL を使用すると、LINQ テクノロジを使用して SQL データベースにアクセスできます。詳細については、「統合言語クエリ (LINQ: Language-Integrated Query)」を参照してください。

このチュートリアルでは、Northwind データベースの Customers テーブルおよび Orders テーブルにマップされる LINQ to SQL エンティティクラスを作成し、Windows フォームにデータを表示するために必要な手順を示します。テーブルのデータを表示する手順に加えて、データを LINQ クエリにバインドする手順も示します。最後に、エンティティクラスからデータベースに更新を送信する既定の LINQ to SQL のロジックを、ストアドプロシージャを使用して置き換える手順を示します。

このチュートリアルでは、次のタスクを実行する方法を学習します。

LINQ to SQL ファイルをプロジェクトに追加します。
データベース内の関連テーブルにマップされる新しいエンティティクラスを作成します。
エンティティクラスを参照するオブジェクトデータソースを作成します。
エンティティクラスにバインドされるコントロールを含む Windows フォームを作成します。
エンティティクラスとデータベース間でデータの読み込みと保存を行うコードを追加します。
単純な LINQ クエリを作成し、フォームに結果を表示します。
O/R デザイナにストアドプロシージャを追加します。
ストアドプロシージャを使用して挿入、更新、および削除を実行するようにエンティティクラスを構成します。

前提条件

このチュートリアルを完了するには、次の条件が必要です。

Northwind サンプルデータベースの SQL Server バージョンにアクセスします。詳細については、「方法 : サンプルデータベースをインストールする」を参照してください。
Northwind データベースに UpdateCustomer ストアドプロシージャが必要です。詳細については、「チュートリアル : Northwind の Customers テーブル用更新ストアドプロシージャの作成」を参照してください。

Windows ベースアプリケーションの作成

ここでは、LINQ to SQL クラスを操作し、Windows フォームにデータを表示するので、このチュートリアルの最初の手順として、新しい Windows フォームアプリケーションを作成します。

メモ :
お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

新しい Windows アプリケーションプロジェクトを作成するには

[ファイル] メニューで新しいプロジェクトを作成します。

プロジェクトに「ORDesignerWalkthrough」という名前を付けます。

メモ :
O/R デザイナは Visual Basic プロジェクトと C# プロジェクトでサポートされているため、新しいプロジェクトはこれらの言語のどちらかで作成してください。

[Windows フォームアプリケーション] テンプレートをクリックし、[OK] をクリックします。詳細については、「Windows ベースのアプリケーションの作成」を参照してください。

ORDesignerWalkthrough プロジェクトが作成されてソリューションエクスプローラに追加されます。

プロジェクトへの LINQ to SQL クラスファイルの追加 (O/R デザイナを開く)

エンティティクラスを作成し、LINQ to SQL クラスファイル (.dbml ファイル) に格納します。.dbml ファイルを開くと、O/R デザイナが開きます。[新しい項目の追加] ダイアログボックスで [LINQ to SQL クラス] テンプレートを選択して、プロジェクトに .dbml ファイルを追加します。

プロジェクトに .dbml ファイルを追加するには

[プロジェクト] メニューの [新しい項目の追加] をクリックします。
[LINQ to SQL クラス] テンプレートをクリックし、[名前] ボックスに「Northwind.dbml」と入力します。
[追加] をクリックします。

プロジェクトに空の LINQ to SQL クラスファイル (Northwind.dbml) が追加され、O/R デザイナが開きます。

新しい LINQ to SQL ファイルをプロジェクトに追加すると、空のデザインサーフェイスが開き、2 つに分割されたペインが表示されます。左側のペインはエンティティペインであり、ここでエンティティクラスを表示および構成します。右側のペインは、デザイナに追加された DataContext メソッドを表示するメソッドペインです。メソッドペインが表示されない場合は、エンティティペインの空の領域を右クリックし、[メソッドペインの表示] をクリックします。空のサーフェイス全体は、構成の準備ができた DataContext を表します。DataContext の名前は、.dbml ファイルに付けた名前に対応します。このチュートリアルでは、LINQ to SQL ファイルに Northwind.dbml という名前を付けたので、DataContext は NorthwindDataContext という名前になります。デザイナの空の領域をクリックし、[プロパティ] ウィンドウを調べることで、これを確認できます。

メモ :
DataContext クラスには、データベースに接続し、データベース内のデータを操作する (たとえば、挿入、更新、および削除を実行する) ためのメソッドとプロパティが含まれています。詳細については、「DataContext メソッド (O/R デザイナ)」を参照してください。

Customer エンティティクラスと Order エンティティクラスの作成

サーバーエクスプローラまたはデータベースエクスプローラから O/R デザイナにテーブルをドラッグして、データベーステーブルにマップされた LINQ to SQL クラスを作成します。結果は、データベース内のテーブルにマップされた LINQ to SQL エンティティクラスになります。

O/R デザイナに Customer エンティティクラスを追加するには

サーバーエクスプローラまたはデータベースエクスプローラで、Northwind サンプルデータベースの SQL Server バージョンのテーブルを探します。詳細については、「方法 : Northwind データベースへのデータ接続を作成する」を参照してください。

サーバーエクスプローラまたはデータベースエクスプローラから O/R デザイナサーフェイスに [Customers] ノードをドラッグします。

Customer という名前のエンティティクラスが作成されます。これには、Customers テーブルの列に対応するプロパティが含まれています。このエンティティクラスは Customers テーブルの 1 人の顧客を表すため、Customers ではなく Customer という名前が付けられます。

メモ :
このような名前の変更動作を複数形化と呼びます。これは [オプション] ダイアログボックス (Visual Studio) でオンまたはオフにできます。詳細については、「方法 : 複数形化をオンおよびオフにする (O/R デザイナ)」を参照してください。

サーバーエクスプローラまたはデータベースエクスプローラから O/R デザイナサーフェイスに [Orders] ノードをドラッグします。

Order という名前のエンティティクラスが、Customer エンティティクラスへの Customer_Order 関連付け (リレーションシップ) と共に作成されます。これには、Orders テーブルの列に対応するプロパティが含まれています。

メモ :
このエンティティクラスは単一の注文を表すため、Order という名前になります。親クラス (Customer) には、その特定の顧客の注文のコレクションを表す Orders プロパティがあります。LINQ to SQL の関連付けの詳細については、「方法 : LINQ to SQL クラス間の関連付け (リレーションシップ) を作成する (O/R デザイナ)」を参照してください。

このエンティティクラスは単一の注文を表すため、Order という名前になります。親クラス (Customer) には、その特定の顧客の注文のコレクションを表す Orders プロパティがあります。LINQ to SQL の関連付けの詳細については、「方法 : LINQ to SQL クラス間の関連付け (リレーションシップ) を作成する (O/R デザイナ)」を参照してください。

Customer エンティティクラスでのオブジェクトデータソースの作成

エンティティクラスは、パブリックプロパティを持つ他のクラスと同様に、オブジェクトデータソースとして使用できます。これらは [データソース] ウィンドウに追加でき、そこからフォームにドラッグすることで、データバインドコントロール (オブジェクトのパブリックプロパティの値にバインドされるコントロール) を作成できます。エンティティクラスを [データソース] ウィンドウに追加するには、データソース構成ウィザードを実行し、ウィザードでデータソースとして [オブジェクト] をクリックします。

[データソース] ウィンドウに Customer をオブジェクトデータソースとして追加するには

[ビルド] メニューの [ORDesignerWalkthrough のビルド] をクリックして、プロジェクトをビルドします。
[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックします。
[データソースの種類を選択] ページで、[オブジェクト] をクリックし、[次へ] をクリックします。
[ORDesignerWalkthrough] ノード (プロジェクトの名前のノード) を展開し、Customer クラスを探して選択します。

メモ :

Customer クラスが使用可能でない場合は、ウィザードをキャンセルし、プロジェクトをビルドしてからウィザードを再実行します。
[完了] をクリックしてデータソースを作成し、Customer エンティティクラスを [データソース] ウィンドウに追加します。

メモ :
Customer クラスが使用可能でない場合は、ウィザードをキャンセルし、プロジェクトをビルドしてからウィザードを再実行します。

Windows フォームにデータを表示するためのデータバインドコントロールの作成

[データソース] ウィンドウから Windows フォームに LINQ to SQL のデータソース項目をドラッグして、エンティティクラスにバインドされるコントロールを作成します。

エンティティクラスにバインドされるコントロールを追加するには

デザインビューで [Form1] を開きます。
[データソース] ウィンドウから [Form1] に [Customer] ノードをドラッグします。

メモ :

[データソース] ウィンドウを表示するには、[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウから [Form1] に [Orders] ノードをドラッグします。これを CustomerDataGridView の下に配置します。
コードビューで [Form1] を開きます。
フォームに次のコードを追加します。フォームに対してグローバルになるように、Form1 クラスの内部でありながら、どのメソッドにも属さない位置に追加します。
```
Private NorthwindDataContext1 As New NorthwindDataContext
```
```
private NorthwindDataContext northwindDataContext1
    = new NorthwindDataContext();
```

メモ :
[データソース] ウィンドウを表示するには、[データ] メニューの [データソースの表示] をクリックします。

Form_Load イベントのイベントハンドラを作成し、ハンドラに次のコードを追加します。

CustomerBindingSource.DataSource = NorthwindDataContext1.Customers

customerBindingSource.DataSource
    = northwindDataContext1.Customers;

アプリケーションのテスト

アプリケーションを実行します。この時点で、フォームには、Customers テーブルのデータを表示する 1 つの DataGridView と、選択された顧客の注文のデータを表示するもう 1 つの DataGridView が含まれます。

メモ :
保存ボタンが無効になっていることに注意してください。保存機能は次のセクションで実装します。

アプリケーションをテストするには

F5 キーを押します。
データがグリッドに表示されることを確認します。
顧客を選択します。
表示されている注文が選択した顧客の注文であることを確認します。
フォームを閉じます ([デバッグ] メニューの [デバッグの停止] をクリックします)。

保存機能の実装

前に述べたように、既定では保存ボタンが有効ではなく、保存機能は実装されていません。また、オブジェクトデータソースに対してデータバインドコントロールを作成しても、変更されたデータをフォームに保存するコードは自動的には追加されません。ここでは、保存ボタンを有効にし、LINQ to SQL オブジェクトの保存機能を実装する方法について説明します。

保存機能を実装するには

デザインビューで [Form1] を開きます。
CustomerBindingNavigator の保存ボタンを選択します (フロッピーディスクのアイコンのボタン)。
[プロパティ] ウィンドウで、[Enabled] プロパティを [True] に設定します。
保存ボタンをダブルクリックして、イベントハンドラを作成し、コードエディタに切り替えます。

保存ボタンのイベントハンドラに次のコードを追加します。

Try
    NorthwindDataContext1.SubmitChanges()
Catch ex As Exception
    MessageBox.Show(ex.Message)
End Try

try
{
    northwindDataContext1.SubmitChanges();
}
catch (Exception ex)
{
    MessageBox.Show(ex.Message);
}

アプリケーションのテスト

アプリケーションを実行します。保存ボタンが有効になり、データを保存する機能が使用可能になります。

アプリケーションをテストするには

F5 キーを押します。
いずれかのグリッドでデータを変更します (処理中の変更をコミットするために、グリッドで編集した行から別の場所に移動してください)。
保存ボタンをクリックして変更をデータベースに保存します。
フォームを閉じます
F5 キーを押し、変更が永続化されたことを確認します (または、データベース内のテーブルを探して変更が保存されたことを確認します)。

LINQ クエリへのバインド

CustomerBindingSource は、DataContext にバインドする以外に、LINQ クエリに直接バインドすることもできます。LINQ クエリの作成方法の詳細については、「LINQ クエリの概要」を参照してください。

フォームへの Button と TextBox の追加

コントロールを LINQ クエリにバインドする方法を学習するために、クエリパラメータの入力を可能にするコントロールをフォームに追加し、クエリを実行します。

フォームにコントロールを追加するには

デザインビューで [Form1] を開きます。
フォームに TextBox を追加し、[Name] プロパティを「CityTextBox」に設定します。
フォームに Button を追加し、次のプロパティを設定します。
- [Name] = RunQueryButton
- [Text] = Run Query

LINQ クエリへのデータバインド

LINQ クエリを実行するコードを追加します。このクエリは、CityTextBox に入力された値をクエリパラメータとして使用します。

LINQ クエリにバインドするには

RunQueryButton をダブルクリックし、RunQueryButton_click イベントハンドラに次のコードを追加します。

Dim CustomersQuery = From customers in NorthwindDataContext1.Customers _
    Where customers.City = CityTextBox.Text _
    Select customers

CustomerBindingSource.DataSource = CustomersQuery

var CustomersQuery = from customers in northwindDataContext1.Customers
                      where customers.City == CityTextBox.Text
                      select customers;
customerBindingSource.DataSource = CustomersQuery;

アプリケーションのテスト

アプリケーションを実行します。これで、特定の都市の顧客を照会できるようになります。

アプリケーションをテストするには

F5 キーを押します。
テキストボックスに「London」と入力します。
[Run Query] ボタンをクリックします。
City プロパティの値が London である顧客だけが表示されていることを確認します。

更新 (Insert、Update、および Delete) の実行に対する既定の動作のオーバーライド

既定では、更新を実行するロジックは LINQ to SQL ランタイムによって提供されます。ランタイムは、エンティティクラスにデータを設定するために使用される Select ステートメントに基づいて、既定の Insert、Update、および Delete の各ステートメントを作成します。既定の動作を使用しない場合は、更新動作を構成し、データベースのデータの操作に必要な Insert、Update、および Delete を実行する特定のストアドプロシージャを指定できます。この方法は、既定の動作が生成されていない場合、たとえばエンティティクラスが結合テーブルにマップされている場合にも実行できます。また、データベースのテーブルへのアクセスには常にストアドプロシージャを通すようにすると、既定の更新動作をオーバーライドできます。

メモ :
ここでは、Northwind データベースで追加の InsertCustomer、UpdateCustomer、および DeleteCustomer の各ストアドプロシージャを使用できるようにしておく必要があります。これらのストアドプロシージャの作成方法の詳細については、「チュートリアル : Northwind の Customers テーブル用更新ストアドプロシージャの作成」を参照してください。

ここでは、Northwind データベースで追加の InsertCustomer、UpdateCustomer、および DeleteCustomer の各ストアドプロシージャを使用できるようにしておく必要があります。これらのストアドプロシージャの作成方法の詳細については、「チュートリアル : Northwind の Customers テーブル用更新ストアドプロシージャの作成」を参照してください。

既定の更新動作をオーバーライドするには

O/R デザイナで LINQ to SQL ファイルを開きます (ソリューションエクスプローラで Northwind.dbml ファイルをダブルクリックします)。
サーバーエクスプローラまたはデータベースエクスプローラで、Northwind データベースの [ストアドプロシージャ] ノードを展開し、UpdateCustomers ストアドプロシージャを探します。
UpdateCustomers ストアドプロシージャを O/R デザイナにドラッグします。

UpdateCustomers ストアドプロシージャが DataContext のメソッドとしてメソッドペインに追加されます。詳細については、「DataContext メソッド (O/R デザイナ)」を参照してください。
O/R デザイナで [Customer] エンティティクラスを選択します。
[プロパティ] ウィンドウで、オーバーライドするコマンドを選択します (([Insert]、[Update]、または [Delete])。この例では、[Update] プロパティを選択します。
[ランタイムを使用] の横にある省略記号 ([...]) をクリックして、[動作の構成] ダイアログボックスを開きます。
[カスタマイズ] を選択します。
[カスタマイズ] ボックスの一覧の [UpdateCustomers] メソッドをクリックします。
[メソッドの引数] および [クラスのプロパティ] の一覧を調べると、テーブルの一部の列には 2 つのメソッドの引数と 2 つのクラスのプロパティがあることがわかります。これにより、変更を追跡したり、同時実行違反をチェックするステートメントを作成したりすることが簡単になります。

元のメソッド引数 (Original_ArgumentName) を元のプロパティ (PropertyName (オリジナル)) にマップします。このチュートリアルでは、Original_CustomerID 引数を CustomerID (オリジナル) プロパティにマップする必要があります。

メモ :
既定では、メソッド引数は名前が一致した場合にクラスプロパティにマップされます。プロパティ名が変更され、テーブルとエンティティクラス間で一致しなくなったために、デザイナが正しいマッピングを判断できないときは、マップ先となる同等のクラスプロパティを選択することが必要になる場合があります。また、メソッド引数のマップ先として有効なクラスプロパティがない場合は、[クラスのプロパティ] 値を [(なし)] に設定できます。

既定では、メソッド引数は名前が一致した場合にクラスプロパティにマップされます。プロパティ名が変更され、テーブルとエンティティクラス間で一致しなくなったために、デザイナが正しいマッピングを判断できないときは、マップ先となる同等のクラスプロパティを選択することが必要になる場合があります。また、メソッド引数のマップ先として有効なクラスプロパティがない場合は、[クラスのプロパティ] 値を [(なし)] に設定できます。

[OK] をクリックします。

アプリケーションのテスト

アプリケーションを再実行し、データベース内の顧客レコードが UpdateCustomers ストアドプロシージャによって正しく更新されることを確認します。

アプリケーションをテストするには

F5 キーを押します。
ALFKI のグリッドで ContactName 列を探します。
名前を Maria Anders から Anders に変更します。
別の行に移動して変更をコミットします。
保存ボタンをクリックします。
フォームを閉じます
F5 キーを押してアプリケーションを再び実行し、ALFKI の ContactName 列に Anders しか表示されないことを確認します。

次の手順

アプリケーションの要件に応じて、LINQ to SQL エンティティクラスの作成後にいくつかの手順を実行することが必要な場合があります。このアプリケーションで行うことができる拡張には次のものがあります。

Insert コマンドおよび Delete コマンドで使用するストアドプロシージャを追加します。詳細については、「方法 : 更新、挿入、および削除を実行するストアドプロシージャを割り当てる (O/R デザイナ)」を参照してください。
フィルタ処理されたデータを返すために、さまざまな LINQ クエリを作成します。詳細については、「方法 : クエリで情報を取得する (LINQ to SQL)」を参照してください。

参照

LINQ Documentation Roadmap

データへのアクセス (Visual Studio)

チュートリアル : LINQ to SQL クラスの作成 (O/R デザイナ)

前提条件

Windows ベース アプリケーションの作成

新しい Windows アプリケーション プロジェクトを作成するには

プロジェクトへの LINQ to SQL クラス ファイルの追加 (O/R デザイナを開く)

プロジェクトに .dbml ファイルを追加するには

Customer エンティティ クラスと Order エンティティ クラスの作成

O/R デザイナに Customer エンティティ クラスを追加するには

Customer エンティティ クラスでのオブジェクト データ ソースの作成

[データ ソース] ウィンドウに Customer をオブジェクト データ ソースとして追加するには

Windows フォームにデータを表示するためのデータ バインド コントロールの作成

エンティティ クラスにバインドされるコントロールを追加するには

アプリケーションのテスト

アプリケーションをテストするには

保存機能の実装

保存機能を実装するには

アプリケーションのテスト

アプリケーションをテストするには

LINQ クエリへのバインド

フォームへの Button と TextBox の追加

フォームにコントロールを追加するには

LINQ クエリへのデータ バインド

LINQ クエリにバインドするには

アプリケーションのテスト

アプリケーションをテストするには

更新 (Insert、Update、および Delete) の実行に対する既定の動作のオーバーライド

既定の更新動作をオーバーライドするには

アプリケーションのテスト

アプリケーションをテストするには

次の手順

参照

概念

参照

その他の技術情報

その他のリソース

Windows ベースアプリケーションの作成

新しい Windows アプリケーションプロジェクトを作成するには

プロジェクトへの LINQ to SQL クラスファイルの追加 (O/R デザイナを開く)

Customer エンティティクラスと Order エンティティクラスの作成

O/R デザイナに Customer エンティティクラスを追加するには

Customer エンティティクラスでのオブジェクトデータソースの作成

[データソース] ウィンドウに Customer をオブジェクトデータソースとして追加するには

Windows フォームにデータを表示するためのデータバインドコントロールの作成

エンティティクラスにバインドされるコントロールを追加するには

LINQ クエリへのデータバインド