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

既定では、更新を実行するロジックは LINQ to SQL ランタイムによって提供されます。 ランタイムは、テーブルのスキーマ (列定義と主キー情報) に基づいて、既定の Insert、Update、および Delete の各ステートメントを作成します。 既定の動作を使用しない場合は、更新動作を構成し、データベースのデータの操作に必要な Insert、Update、および Delete を実行する特定のストアド プロシージャを指定できます。 この方法は、既定の動作が生成されていない場合、たとえばエンティティ クラスがビューにマップされている場合にも実行できます。 また、データベースのテーブルへのアクセスには常にストアド プロシージャを通すようにすると、既定の更新動作をオーバーライドできます。 詳細については、「ストアド プロシージャによる操作のカスタマイズ」を参照してください。

このチュートリアルでは、ストアド プロシージャを使用して、データベースにデータを保存する既定の LINQ to SQL ランタイムの動作をオーバーライドするために必要な手順を示します。

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

• 新しい Windows フォーム アプリケーションを作成し、LINQ to SQL ファイルを追加します。

• Northwind の Customers テーブルにマップされるエンティティ クラスを作成します。

• LINQ to SQL Customer クラスを参照するオブジェクト データ ソースを作成します。

• Customer クラスにバインドされる DataGridView を含む Windows フォームを作成します。

• フォームの保存機能を実装します。

• O/R デザイナーにストアド プロシージャを追加することにより、DataContext のメソッドを作成します。

• ストアド プロシージャを使用して挿入、更新、および削除を実行するように Customer クラスを構成します。

必須コンポーネント

このチュートリアルを実行するための要件は次のとおりです。

• Northwind サンプル データベースの SQL Server バージョンにアクセスします。 詳細については、「方法 : サンプル データベースをインストールする」を参照してください。

• Northwind データベースに InsertCustomer、UpdateCustomer、および DeleteCustomer の各ストアド プロシージャが必要です。 詳細については、「チュートリアル: Northwind の Customers テーブル用 Update ストアド プロシージャの作成」を参照してください。

アプリケーションの作成と LINQ to SQL クラスの追加

LINQ to SQL クラスを操作してデータを Windows フォームに表示できるように、新しい Windows フォーム アプリケーションを作成し、LINQ to SQL クラス ファイルを追加します。

LINQ to SQL クラスを含む新しい Windows アプリケーション プロジェクトを作成するには

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

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

   注意

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

3. [Windows フォーム アプリケーション] テンプレートをクリックし、[OK] をクリックします。 詳細については、「.NET Framework を使用したクライアント アプリケーションの開発」を参照してください。

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

4. [プロジェクト] メニューの [新しい項目の追加] をクリックします。

5. [LINQ to SQL クラス] テンプレートをクリックし、[名前] ボックスに「Northwind.dbml」と入力します。

6. [追加] をクリックします。

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

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

サーバー エクスプローラーまたはデータベース エクスプローラーから O/R デザイナーにテーブルをドラッグして、データベース テーブルにマップされた LINQ to SQL クラスを作成します。 結果は、データベース内のテーブルにマップされた LINQ to SQL エンティティ クラスになります。 作成したエンティティ クラスは、パブリック プロパティを持つ他のクラスと同様に、オブジェクト データ ソースとして使用できます。

Customer エンティティ クラスを作成し、そのエンティティ クラスでデータ ソースを構成するには

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

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

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

   注意

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

3. [ビルド] メニューの [UpdatingwithSProcsWalkthrough のビルド] をクリックして、プロジェクトをビルドします。

4. [データ] メニューの [データ ソースの表示] をクリックします。

5. [データ ソース] ウィンドウで、[新しいデータ ソースの追加] をクリックします。

6. [データソースの種類を選択] ページで、[オブジェクト] をクリックし、[次へ] をクリックします。

7. [UpdatingwithSProcsWalkthrough] ノードを展開し、[Customer] クラスを探して選択します。

   注意

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

8. [完了] をクリックしてデータ ソースを作成し、Customer エンティティ クラスを [データ ソース] ウィンドウに追加します。

Windows フォームに顧客データを表示するための DataGridView の作成

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

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

1. デザイン ビューで [Form1] を開きます。

2. [データ ソース] ウィンドウから [Form1] に [Customer] ノードをドラッグします。

   注意

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

3. コード エディターで Form1 を開きます。

4. フォームに次のコードを追加します。フォームに対してグローバルになるように、Form1 クラスの内部でありながら、どのメソッドにも属さない位置に追加します。

   Private NorthwindDataContext1 As New NorthwindDataContext
   

   private NorthwindDataContext northwindDataContext1
       = new NorthwindDataContext();
   

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

   CustomerBindingSource.DataSource = NorthwindDataContext1.Customers
   

   customerBindingSource.DataSource
       = northwindDataContext1.Customers;
   

保存機能の実装

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

保存機能を実装するには

1. デザイン ビューで [Form1] を開きます。

2. CustomerBindingNavigator の保存ボタン (フロッピー ディスクのアイコンのボタン) を選択します。

3. [プロパティ] ウィンドウで、[Enabled] プロパティを [True] に設定します。

4. 保存ボタンをダブルクリックして、イベント ハンドラーを作成し、コード エディターに切り替えます。

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

   NorthwindDataContext1.SubmitChanges()
   

   northwindDataContext1.SubmitChanges();
   

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

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

1. O/R デザイナーで LINQ to SQL ファイルを開きます (ソリューション エクスプローラーで Northwind.dbml ファイルをダブルクリックします)。

2. サーバー エクスプローラーまたはデータベース エクスプローラーで、Northwind データベースの [ストアド プロシージャ] ノードを展開し、InsertCustomers、UpdateCustomers、および DeleteCustomers の各ストアド プロシージャを探します。

3. 3 つのストアド プロシージャをすべて O/R デザイナーにドラッグします。

   各ストアド プロシージャが DataContext のメソッドとしてメソッド ペインに追加されます。 詳細については、「DataContext メソッド (O/R デザイナー)」を参照してください。

4. O/R デザイナーで [Customer] エンティティ クラスを選択します。

5. [プロパティ] ウィンドウで [Insert] プロパティを選択します。

6. [ランタイムを使用] の横にある省略記号 ([...]) をクリックして、[動作の構成] ダイアログ ボックスを開きます。

7. [カスタマイズ] を選択します。

8. [カスタマイズ] ボックスの一覧の [InsertCustomers] メソッドをクリックします。

9. [適用] をクリックして、選択したクラスと動作の構成を保存します。

   注意

   変更を行うたびに [適用] をクリックすると、各クラスと動作の組み合わせに対して動作の構成を続行できます。[適用] をクリックする前にクラスまたは動作を変更した場合は、警告ダイアログ ボックスが表示され、ここで変更を適用できます。

10. [動作] ボックスの一覧の [Update] をクリックします。

11. [カスタマイズ] を選択します。

12. [カスタマイズ] ボックスの一覧の [UpdateCustomers] メソッドをクリックします。

    [メソッドの引数] および [クラスのプロパティ] の一覧を調べると、テーブルの一部の列には 2 つのメソッドの引数と 2 つのクラスのプロパティがあることがわかります。 これにより、変更を追跡したり、同時実行違反をチェックするステートメントを作成したりすることが簡単になります。

13. Original_CustomerID メソッド引数を CustomerID (オリジナル) クラス プロパティにマップします。

    注意

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

14. [適用] をクリックして、選択したクラスと動作の構成を保存します。

15. [動作] ボックスの一覧の [Delete] をクリックします。

16. [カスタマイズ] を選択します。

17. [カスタマイズ] ボックスの一覧の [DeleteCustomers] メソッドをクリックします。

18. Original_CustomerID メソッド引数を CustomerID (オリジナル) クラス プロパティにマップします。

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

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

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

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

1. F5 キーを押します。

2. グリッド内のレコードを変更して、Update の動作をテストします。

3. 新しいレコードを追加して、Insert の動作をテストします。

4. 保存ボタンをクリックして変更をデータベースに保存します。

5. フォームを閉じます

6. F5 キーを押し、更新されたレコードと新しく挿入したレコードが永続化されていることを確認します。

7. 手順 3. で作成した新しいレコードを削除して、Delete の動作をテストします。

8. 保存ボタンをクリックして変更を送信し、削除されたレコードをデータベースから削除します。

9. フォームを閉じます

10. F5 キーを押し、削除したレコードがデータベースから削除されていることを確認します。

    注意

    アプリケーションで SQL Server Express Edition を使用している場合、データベース ファイルの [出力ディレクトリにコピー] プロパティの値によっては、手順 10. で F5 キーを押したときに変更が表示されない場合があります。詳細については、「方法 : プロジェクトでローカル データ ファイルを管理する」を参照してください。

次の手順

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

• 更新時の同時実行チェックを実装します。 詳細については、「オプティミスティック同時実行の概要」を参照してください。

• LINQ クエリを追加してデータをフィルター処理します。 詳細については、「LINQ クエリの概要 (C#)」を参照してください。

参照

処理手順

方法 : 更新、挿入、および削除を実行するストアド プロシージャを割り当てる (O/R デザイナー)

概念

LINQ to SQL クエリ

DataContext メソッド (O/R デザイナー)

その他の技術情報

オブジェクト リレーショナル デザイナー (O/R デザイナー)

LINQ to SQL [LINQ to SQL]

Visual Studio 2012 のデータ アプリケーション開発に関する新機能