.NET Framework アプリケーションのデータセット内のデータを検証する

[アーティクル]
05/01/2023

Note

データセットと関連クラスは、アプリケーションがデータベースから切断されている間にアプリケーションがメモリ内のデータを操作できるようにする、2000 年代初期からのレガシ .NET Framework テクノロジです。これらが特に役立つのは、ユーザーがデータを変更し、変更をデータベースに戻して保持できるようにするアプリケーションです。データセットは非常に優れたテクノロジであることが証明されていますが、新しい .NET アプリケーションでは Entity Framework Core を使用することをお勧めしています。 Entity Framework には、オブジェクトモデルとして表形式データを操作する、より自然な方法が用意されており、よりシンプルなプログラミングインターフェイスが備わっています。

データの検証とは、データオブジェクトに入力される値が、データセットのスキーマ内の制約に準拠していることを確認するプロセスのことです。また、検証プロセスでは、これらの値が、アプリケーションに対して設定されている規則に従っているかどうかも確認されます。データの検証は、基になるデータベースに更新を送信する前に実行することをお勧めします。そうすることで、エラーを減らせるだけでなく、アプリケーションとデータベースの間で生じる可能性のある、ラウンドトリップの回数も減らせます。

データセットに書き込まれようとしてるデータが有効であるかどうかは、データセット自体に検証チェックを組み込むことによって確認できます。データセットでは、更新の実行方法 (フォーム内のコントロールによって直接実行されるか、コンポーネント内で実行されるか、またはその他の方法で実行されるか) に関係なく、データを確認できます。データセットは (データベースバックエンドとは違って) アプリケーションの一部であるため、アプリケーション固有の検証を構築するための論理的な場所となります。

アプリケーションに検証を追加するための最適な場所は、データセットの部分クラスファイルです。 Visual Basic または Visual C# で、データセットデザイナーを開き、検証を作成する列またはテーブルをダブルクリックします。このアクションにより、コードファイルが開き、ここに ColumnChanging または RowChanging イベントハンドラーを作成できます。

private static void OnColumnChanging(object sender, DataColumnChangeEventArgs e)
{

}

Private Shared Sub OnColumnChanging(sender As Object, e As DataColumnChangeEventArgs)

End Sub

データの検証

データセット内での検証は、次の方法で実現されます。

アプリケーション固有の検証を独自に作成して、個々のデータ列の変更時にその値をチェックできるようにする。詳細については、「方法: 列の変更時にデータを検証する」を参照してください。
アプリケーション固有の検証を独自に作成して、データ行全体が変更される際に、データの値をチェックできるようにする。詳細については、「方法: 行の変更時にデータを検証する」を参照してください。
データセットの実際のスキーマ定義の一部として、キー、一意の制約などを作成する。
DataColumn オブジェクトのプロパティ (MaxLength、AllowDBNull、Unique など) を設定する。

レコードで変更が発生すると、DataTable オブジェクトによっていくつかのイベントが発生します。

ColumnChanging および ColumnChanged イベントは、個々の列の変更時と変更後にそれぞれ発生します。 ColumnChanging イベントは、特定の列の変更を検証する場合に便利です。提案された変更に関する情報は、イベントの引数として渡されます。
RowChanging および RowChanged イベントは、行の変更時と変更後にそれぞれ発生します。 RowChanging イベントの方がより一般的です。これは、行のどこかで変更が発生していることを示すもので、どの列が変更されたかはわかりません。

既定では、列が変更されるたびに、4 つのイベントが発生することになります。まずは、変更されようとしている列の ColumnChanging および ColumnChanged イベントです。次に、RowChanging および RowChanged イベントです。行に対して複数の変更が行われようとしている場合は、各変更に対してイベントが発生します。

注意

データ行の BeginEdit メソッドは、個々の列が変更された後、RowChanging イベントと RowChanged イベントをオフにします。その場合、イベントは EndEdit メソッドが呼び出されるまで発生しません。その際、RowChanging イベントと RowChanged イベントが 1 回だけ発生します。詳細については、「データセットの読み込み中に制約をオフにする」を参照してください。

どのイベントを選択するかは、検証をどの粒度で行うかによって決まってきます。列が変更されたとき、すぐにエラーをキャッチすることが重要な場合は、ColumnChanging イベントを使って検証を作成します。それ以外の場合は、RowChanging イベントを使用します。その場合、一度に複数のエラーがキャッチされる可能性があります。また、データが構造化されていて、ある列の値が別の列の内容に基づいて検証される場合は、RowChanging イベント中に検証を実行します。

レコードが更新されると、DataTable オブジェクトによってイベントが発生します。これらに対しては、変更の発生時と発生後に応答することができます。

アプリケーションで型指定されたデータセットが使われる場合は、厳密に型指定されたイベントハンドラーを作成できます。これにより、型指定された 4 つのイベント (dataTableNameRowChanging、dataTableNameRowChanged、dataTableNameRowDeleting、および dataTableNameRowDeleted) が追加されるので、それらに対してハンドラーを作成できます。これらの型指定されたイベントハンドラーでは、テーブルの列名を含んだ引数が渡されます。これにより、コードの記述と読み取りが容易になります。

データ更新イベント

event	説明
ColumnChanging	列の値が変更されようとしています。このイベントでは、行と列、そして提案された新しい値が渡されます。
ColumnChanged	列の値が変更されました。このイベントでは、行と列、そして提案された値が渡されます。
RowChanging	DataRow オブジェクトに対して行われた変更が、データセットにコミットされようとしています。 BeginEdit メソッドを呼び出していない場合は、列が変更されるたび、ColumnChanging イベントの発生直後に RowChanging イベントが発生します。変更を加える前に BeginEdit を呼び出した場合、RowChanging イベントは、EndEdit メソッドを呼び出したときにのみ発生します。このイベントでは、行と共に、実行されようとしているアクションの種類 (変更、挿入など) を示す値が渡されます。
RowChanged	行が変更されました。このイベントでは、行と共に、実行されようとしているアクションの種類 (変更、挿入など) を示す値が渡されます。
RowDeleting	行が削除されようとしています。このイベントでは、行と共に、実行されようとしているアクションの種類 (削除) を示す値が渡されます。
RowDeleted	行が削除されました。このイベントでは、行と共に、実行されようとしているアクションの種類 (削除) を示す値が渡されます。

ColumnChanging、RowChanging、および RowDeleting イベントは、更新プロセス中に発生します。これらのイベントは、データを検証したり、その他の種類の処理を実行するために使用できます。これらのイベント中は更新が処理中であるため、例外をスローして更新を取り消すこともできます。そうすることで、更新が完了するのを防ぐことができます。

ColumnChanged、RowChanged、および RowDeleted イベントは、更新が正常に完了したときに発生する通知イベントです。これらのイベントは、更新が正常に行われた後、さらにアクションを実行する場合に便利です。

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

Note

データセットデザイナーでは、データセットに検証ロジックを追加できる、部分クラスが作成されます。デザイナーによって生成されたデータセットは、部分クラス内のコードを削除したり変更したりするものではありません。

データ列の値が変更される際には、ColumnChanging イベントに応答することで、データを検証することができます。このイベントが発生すると、現在の列に対して提案されている値を含んだイベント引数 (ProposedValue) が渡されます。 e.ProposedValue の内容に基づいて、次の操作を実行できます。

何もせずに、指示された値を受け入れます。
列変更イベントハンドラー内から列エラー (SetColumnError) を設定して、提案された値を拒否します。
オプションで ErrorProvider コントロールを使用して、ユーザーにエラーメッセージを表示します。詳細については、「ErrorProvider コンポーネント」を参照してください。

検証は、RowChanging イベント中に実行することもできます。

行の変更時にデータを検証する

検証する各列にアプリケーションの要件を満たすデータが格納されていることを検証するコードを記述できます。これを行うには、提案された値が受け入れられものである場合に、エラーが含まれていることを示すように列を設定します。 Quantity 列が 0 以下の場合に列エラーを設定する例を次に示します。行変更イベントハンドラーは、次のように記述します。

行の変更時にデータを検証するには (Visual Basic)

データセットデザイナーでご自分のデータセットを開きます。詳細については、「チュートリアル: データセットデザイナーを使用したデータセットの作成」を参照してください。
検証するテーブルのタイトルバーをダブルクリックします。この操作により、データセットの部分クラスファイルに RowChanging の DataTable イベントハンドラーが自動的に作成されます。

ヒント

テーブル名の左側をダブルクリックして、行変更イベントハンドラーを作成します。テーブル名をダブルクリックすると、名前を編集できます。
```
Private Sub Order_DetailsDataTable_Order_DetailsRowChanging(
    ByVal sender As System.Object, 
    ByVal e As Order_DetailsRowChangeEvent
  ) Handles Me.Order_DetailsRowChanging

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

行の変更時にデータ検証するには (C#)

データセットデザイナーでご自分のデータセットを開きます。詳細については、「チュートリアル: データセットデザイナーを使用したデータセットの作成」を参照してください。
検証するテーブルのタイトルバーをダブルクリックします。この操作により、DataTable の部分クラスファイルが作成されます。

Note

データセットデザイナーでは、RowChanging イベントのイベントハンドラーが自動作成されません。 RowChanging イベントを処理するメソッドを作成し、そのイベントをフックするコードをテーブルの初期化メソッドで実行する必要があります。

部分クラスに次のコードをコピーします。

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", "");
    }
}

変更された行を取得する

データテーブルの各行には、DataRowState 列挙体の値を使ってその行の現在の状態を追跡する、RowState プロパティがあります。 DataSet または DataTable の GetChanges メソッドを呼び出すと、データセットやデータテーブルから変更された行を返すことができます。データセットの HasChanges メソッドを呼び出せば、GetChanges を呼び出す前に、変更が存在するかどうかを確認できます。

注意

(AcceptChanges メソッドを呼び出して) データセットやデータテーブルに変更をコミットすると、GetChanges メソッドはデータを返さなくなります。変更された行をアプリケーションで処理する必要がある場合は、AcceptChanges メソッドを呼び出す前に変更を処理する必要があります。

データセットまたはデータテーブルの GetChanges メソッドを呼び出すと、変更されたレコードのみを含んだ、新しいデータセットまたはデータテーブルが返されます。新しいレコードのみ、または変更されたレコードのみを取得するなど、特定のレコードを取得したい場合は、DataRowState 列挙体の値を GetChanges メソッドへのパラメーターとして渡すことができます。

異なるバージョンの行 (たとえば、行を処理する前の元の値) にアクセスするには、DataRowVersion 列挙体を使用します。

データセットから変更されたすべてのレコードを取得するには

データセットの GetChanges メソッドを呼び出します。

次の例では、changedRecords という新しいデータセットを作成し、dataSet1 という別のデータセットから、変更されたすべてのレコードを設定します。
- C#
- VB
```
DataSet changedRecords = dataSet1.GetChanges();
```
```
Dim changedRecords As DataSet = DataSet1.GetChanges()
```

データテーブルから変更されたすべてのレコードを取得するには

DataTable の GetChanges メソッドを呼び出します。

次の例では、changedRecordsTable という新しいデータテーブルを作成し、dataTable1 という別のデータテーブルから、変更されたすべてのレコードを設定します。
- C#
- VB
```
DataTable changedRecordsTable = dataTable1.GetChanges();
```
```
Dim changedRecordsTable As DataTable = dataTable1.GetChanges()
```

行が特定の状態にあるすべてのレコードを取得するには

データセットまたはデータテーブルの GetChanges メソッドを呼び出し、DataRowState 列挙値を引数として渡します。

次の例は、addedRecords という新しいデータセットを作成し、dataSet1 データセットに追加されたレコードのみを設定する方法を示しています。

DataSet addedRecords = dataSet1.GetChanges(DataRowState.Added);

Dim addedRecords As DataSet = DataSet1.GetChanges(DataRowState.Added)

次の例は、Customers テーブルに最近追加されたすべてのレコードを返す方法を示しています。

private NorthwindDataSet.CustomersDataTable GetNewRecords()
{
    return (NorthwindDataSet.CustomersDataTable)
        northwindDataSet1.Customers.GetChanges(DataRowState.Added);
}

Private Function GetNewRecords() As NorthwindDataSet.CustomersDataTable

    Return CType(NorthwindDataSet1.Customers.GetChanges(Data.DataRowState.Added),
        NorthwindDataSet.CustomersDataTable)
End Function

DataRow の元のバージョンにアクセスする

データ行を変更すると、データセットにその行の元のバージョン (Original) と新しいバージョン (Current) が保存されます。たとえば、AcceptChanges メソッドを呼び出す前にレコードの別のバージョン (DataRowVersion 列挙定数で定義) にアクセスし、そのバージョンに応じて変更を処理できます。

Note

別のバージョンの行が存在するのは、その行が編集されてから AcceptChanges メソッドが呼び出されるまでの間です。 AcceptChanges メソッドの呼び出し後は、現在のバージョンと元のバージョンが同じになります。

DataRowVersion 値を列インデックス (文字列である列名) と共に渡すと、その列の特定の行バージョンから値が返されます。変更された列は、ColumnChanging イベントと ColumnChanged イベントの発生時に識別されます。検証目的で複数の行バージョンを検査するには、これが最適なタイミングです。ただし、一時的に制約を中断しているときはこれらのイベントは発生しないため、変更された列をプログラムで識別する必要があります。 Columns コレクションを反復処理し、異なる DataRowVersion 値を比較することにより変更された列を識別できます。

レコードの元のバージョンを取得するには

取得する行の DataRowVersion を渡して列の値にアクセスします。

次の例は、DataRowVersion 値を使って、DataRow の CompanyName フィールドの元の値を取得する方法を示しています。

string originalCompanyName;
originalCompanyName = northwindDataSet1.Customers[0]
    ["CompanyName", DataRowVersion.Original].ToString();

Dim originalCompanyName = NorthwindDataSet1.Customers(0)(
   "CompanyName", DataRowVersion.Original).ToString()

DataRow の現在のバージョンにアクセスする

レコードの現在のバージョンを取得するには

列の値にアクセスした後、どのバージョンの行を取得するかを示すインデックスに、パラメーターを追加します。

次の例は、DataRowVersion 値を使って、DataRow の CompanyName フィールドの現在の値を取得する方法を示しています。
- C#
- VB
```
string currentCompanyName;
currentCompanyName = northwindDataSet1.Customers[0]
    ["CompanyName", DataRowVersion.Current].ToString();
```
```
Dim currentCompanyName = NorthwindDataSet1.Customers(0)(
    "CompanyName", DataRowVersion.Current).ToString()
```

.NET Framework アプリケーションのデータセット内のデータを検証する

データの検証

データ更新イベント

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

行の変更時にデータを検証する

行の変更時にデータを検証するには (Visual Basic)

行の変更時にデータ検証するには (C#)

変更された行を取得する

データセットから変更されたすべてのレコードを取得するには

データテーブルから変更されたすべてのレコードを取得するには

行が特定の状態にあるすべてのレコードを取得するには

DataRow の元のバージョンにアクセスする

レコードの元のバージョンを取得するには

DataRow の現在のバージョンにアクセスする

レコードの現在のバージョンを取得するには

フィードバック

フィードバック

その他のリソース

.NET Framework アプリケーションのデータセット内のデータを検証する

データの検証

データ更新イベント

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

行の変更時にデータを検証する

行の変更時にデータを検証するには (Visual Basic)

行の変更時にデータ検証するには (C#)

変更された行を取得する

データセットから変更されたすべてのレコードを取得するには

データ テーブルから変更されたすべてのレコードを取得するには

行が特定の状態にあるすべてのレコードを取得するには

DataRow の元のバージョンにアクセスする

レコードの元のバージョンを取得するには

DataRow の現在のバージョンにアクセスする

レコードの現在のバージョンを取得するには

関連するコンテンツ

フィードバック

フィードバック

その他のリソース

データテーブルから変更されたすべてのレコードを取得するには