チュートリアル : データセットへの検証の追加

このチュートリアルでは、データセット内のデータに変更が加えられたときにデータを検証する方法を示します。データの検証をどこで実行するかは、アプリケーションの要件によって異なります。このチュートリアルでは、列内の値が変更される時点でデータを検証します。ここでは、ColumnChanging イベントを使用して、有効な値がレコードに入力されていることを検証します。値が無効な場合は、ErrorProvider コントロールが表示されます。

また、この例では、データセットデザイナーを使ってデータセットの部分クラスを作成する方法も示します。(部分クラスには、ユーザーがコードを追加して Visual Studio 生成データセットの機能を拡張できます。データセットが再生成されても、追加コードは上書きされません。)

[!メモ]

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

このチュートリアルでは、以下のタスクを行います。

新しい Windows アプリケーション プロジェクトを作成します。
データソース構成ウィザードを使用して、データセットを作成して構成します。
[データソース] ウィンドウから項目をドラッグしたときにフォーム上に作成するコントロールを選択します。詳細については、「方法 : [データソース] ウィンドウからドラッグしたときに作成されるコントロールを設定する」を参照してください。
[データソース] ウィンドウから Windows フォームに項目をドラッグすると、データバインドコントロールを作成できます。
部分クラスを作成して、データセットの機能を拡張します。
OrderDetails テーブルの ColumnChanging イベントのイベントハンドラーを作成します。
Quantity 列の値が 0 より大きいことを確認する入力規則を追加します。
ErrorProvider コンポーネント (Windows フォーム) を表示して、データバインドコントロールに無効な値が含まれていることをユーザーに通知します。

必須コンポーネント

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

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

新しい Windows アプリケーションの作成

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

[ファイル] メニューで新しいプロジェクトを作成します。
プロジェクトに「ValidationWalkthrough」という名前を付けます。
[Windows アプリケーション] をクリックし、[OK] をクリックします。詳細については、「クライアントアプリケーションの開発」を参照してください。

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

データベースから新規データソースを作成する

データソースを作成するには

[データ] メニューの [データソースの表示] をクリックします。
[データソース] ウィンドウで、[新しいデータソースの追加] をクリックしてデータソース構成ウィザードを起動します。
[データソースの種類を選択] ページで、[データベース] をクリックし、[次へ] をクリックします。
[データ接続の選択] ページで、次のいずれかの操作を行います。
- Northwind サンプルデータベースへのデータ接続がドロップダウンリストに表示されている場合は選択します。
  
  または
- [新しい接続] を選択して [接続の追加] または [接続の変更] ダイアログボックスを表示します。詳細については、「[接続の追加] ダイアログボックスと [接続の変更] ダイアログボックス (一般)」を参照してください。
データベースにパスワードが必要な場合は、該当するオプションを選択して重要情報を含め、[次へ] をクリックします。
[アプリケーション構成ファイルに接続文字列を保存] ページで、[次へ] をクリックします。
[データベースオブジェクトの選択] ページの [テーブル] ノードを展開します。
[Order Details] テーブルを選択し、[完了] をクリックします。

プロジェクトに [NorthwindDataSet] が追加され、[データソース] ウィンドウに [Order Details] テーブルが表示されます。

データバインドコントロールの作成

フォームにデータバインドコントロールを作成するには

[データソース] ウィンドウで、[Order Details] テーブルを選択します。
テーブルのコントロールリストの [詳細] をクリックします。
[データソース] ウィンドウから Form1 に [Order Details] ノードをドラッグします。

説明のラベルが付いたデータバインドコントロールとレコード間を移動するためのツールストリップ (BindingNavigator) がフォームに表示されます。説明のラベルが付いたデータバインドコントロールとレコード間を移動するためのツールストリップ (BindingNavigator) がフォームに表示されます。NorthwindDataSet、Order_DetailsTableAdapter、BindingSource、および BindingNavigator がコンポーネントトレイに表示されます。

フォームへの ErrorProvider コントロールの追加

ErrorProvider コントロールを構成するには

ツールボックスから Form1 に ErrorProvider をドラッグします。
[プロパティ] ウィンドウで、ErrorProvider の DataSource プロパティを Order_DetailsBindingSource に設定します。

[!メモ]

DataMember プロパティを設定しないでください。

ColumnChanging イベントハンドラーの作成

入力規則イベントハンドラーを作成するには

ソリューションエクスプローラーで NorthwindDataSet.xsd ファイルをダブルクリックし、NorthwindDataSet をデータセットデザイナーで開きます。
OrderDetails テーブルの Quantity 列をダブルクリックして OrderDetailsDataTable_ColumnChanging イベントハンドラーを作成します (C# では、データテーブルの部分クラスのみが作成されます)。

[!メモ]

テーブル名 (タイトルバーの [Order Details]) をダブルクリックして、RowChanging イベントのイベントハンドラーを作成します。

e.ProposedValue に 0 より大きい値が含まれていることを確認するコードを追加します。指定された値が 0 以下の場合、エラーがあることを表すように該当する列を設定します。

次のコードを列変更イベントハンドラーの "Add user code here" というコメントの下に貼り付けます。

If CType(e.ProposedValue, Short) <= 0 Then
        e.Row.SetColumnError(e.Column, "Quantity must be greater than 0")
    Else
        e.Row.SetColumnError(e.Column, "")
End If

// C#
// Add the following code 
// to the partial class.
    public override void EndInit()
    {
        base.EndInit();
        Order_DetailsRowChanging += TestRowChangeEvent;
    }

    public void TestRowChangeEvent(object sender, Order_DetailsRowChangeEvent e)
    {
        if ((short)e.Row.Quantity <= 0)
        {
            e.Row.SetColumnError("Quantity", "Quantity must be greater than 0");
        }
        else
        {
            e.Row.SetColumnError("Quantity", "");
        }
    }