エンティティ クラスに検証を追加する

エンティティ クラスの "検証" とは、データ オブジェクトに入力された値が、アプリケーションに対して設定された規則に従っていること、およびオブジェクトのスキーマ内の制約に従っていることを確認するプロセスです。 基になるデータベースに更新を送信する前にデータを検証すると、エラーを減らすことができます。 アプリケーションとデータベースの間で生じる可能性のあるラウンド トリップの回数も減ります。

Visual Studio の LINQ to SQL ツールで提供される部分メソッドを使用すると、完全なエンティティの挿入、更新、削除時と、個々の列の変更中および変更後に実行される、デザイナーで生成されたコードを拡張できます。

特定の列の値の変更に対する検証を追加する

この手順では、列の値の変更時にデータを検証する方法を示します。 検証はユーザー インターフェイスではなくクラス定義の内部で実行されるため、値によって検証が失敗する場合は例外がスローされます。 列の値を変更しようとするアプリケーションのコードには、エラー処理を実装してください。

列の値の変更時にデータを検証するには

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

2. O/R デザイナーで、検証を追加するクラスを右クリックして、[コードの表示] を選択します。

   コード エディターが開き、選択したエンティティ クラスの部分クラスが表示されます。

3. 部分クラスにカーソルを置きます。

4. Visual Basic プロジェクトの場合は、次の操作を行います。

   1. [メソッド名] の一覧を展開します。

   2. 検証を追加する列の OnCOLUMNNAMEChanging メソッドを見つけます。

   3. OnCOLUMNNAMEChanging メソッドが部分クラスに追加されます。

   4. 次のコードを追加して、まず値が入力されたことを確認し、次に列に入力された値がアプリケーションで許容されることを確認します。 入力された値は value 引数に含まれています。そこで、これが有効な値であることを確認するロジックを追加します。

      If value.HasValue Then
          ' Add code to ensure that the value is acceptable.
          ' If value < 1 Then
          '    Throw New Exception("Invalid data!")
          ' End If
      End If
      

   C# プロジェクトの場合は、次の操作を行います。

   C# プロジェクトでは、イベント ハンドラーは自動的には生成されないため、IntelliSense を使用して列変更部分メソッドを作成します。 「partial」に続けてスペースを入力して、使用可能な部分メソッドの一覧にアクセスします。 検証を追加する列の列変更メソッドをクリックします。 列変更部分メソッドを選択したときに生成されるコードは次のようになります。

   partial void OnCOLUMNNAMEChanging(COLUMNDATATYPE value)
       {
          throw new System.NotImplementedException();
       }
   

エンティティ クラスの更新の検証を追加する

変更時の値のチェックに加えて、エンティティ クラス全体の更新が試行されたときにデータを検証することもできます。 更新の試行時の検証では、ビジネス ルールにおける必要性に応じて複数の列の値を比較できます。 次の手順は、エンティティ クラス全体の更新が試行されたときに検証を行う方法を示しています。

エンティティ クラスの更新時にデータを検証するには

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

2. O/R デザイナーで空の領域を右クリックし、[コードの表示] をクリックします。

   コード エディターが開き、DataContext の部分クラスが表示されます。

3. DataContext の部分クラスにカーソルを置きます。

4. Visual Basic プロジェクトの場合は、次の操作を行います。

   1. [メソッド名] の一覧を展開します。

   2. [UpdateENTITYCLASSNAME] をクリックします。

   3. UpdateENTITYCLASSNAME メソッドが部分クラスに追加されます。

   4. 次のコードに示すように、instance 引数を使用して個々の列の値にアクセスします。

      If (instance.COLUMNNAME = x) And (instance.COLUMNNAME = y) Then
          Dim ErrorMessage As String = "Invalid data!"
          Throw New Exception(ErrorMessage)
      End If
      

   C# プロジェクトの場合は、次の操作を行います。

   C# プロジェクトでは、イベント ハンドラーは自動的には生成されないため、IntelliSense を使用して UpdateCLASSNAME 部分メソッドを作成します。 「partial」に続けてスペースを入力して、使用可能な部分メソッドの一覧にアクセスします。 検証を追加するクラスの更新メソッドをクリックします。 UpdateCLASSNAME 部分メソッドを選択したときに生成されるコードは次のようになります。

   partial void UpdateCLASSNAME(CLASSNAME instance)
   {
       if ((instance.COLUMNNAME == x) && (instance.COLUMNNAME = y))
       {
           string ErrorMessage = "Invalid data!";
           throw new System.Exception(ErrorMessage);
       }
   }
   

関連するコンテンツ

• Visual Studio の LINQ to SQL ツール
• データの検証
• LINQ to SQL (.NET Framework)