次の方法で共有


DataTable の編集

更新 : November 2007

DataRow 内の列値を変更すると、その変更はすぐに行の現在の状態に反映されます。次に、DataRowStateModified に設定され、DataRowAcceptChanges メソッドまたは RejectChanges メソッドを使用して変更が受け入れられるかまたは拒否されます。DataRow は、行の編集中に、その行の状態を保留にしておくために使用できる 3 つのメソッドも提供します。これらのメソッドとは、BeginEditEndEdit および CancelEdit です。

DataRow の列値が直接変更されると、DataRow は、CurrentDefaultOriginal の各行バージョンを使用して列値を管理します。BeginEditEndEditCancelEdit の各メソッドでは、これらの行バージョンに加えて、4 番目の行バージョン Proposed を使用します。行バージョンの詳細については、「行の状態とバージョン」を参照してください。

Proposed 行バージョンは、編集操作中に存在するバージョンです。編集操作は、BeginEdit への呼び出しによって開始し、EndEdit または CancelEdit の使用あるいは AcceptChanges または RejectChanges の呼び出しによって終了します。

編集操作中に、DataTableColumnChanged イベントで ProposedValue を評価することにより、個々の列に検証ロジックを適用できます。ColumnChanged イベントは、変更されている列への参照および ProposedValue への参照を維持する DataColumnChangeEventArgs を保持します。提示された値を評価した後で、値を変更するか、または編集をキャンセルできます。編集が終了すると、行は Proposed 状態ではなくなります。

EndEdit を呼び出すと編集内容を確定でき、CancelEdit を呼び出すと編集内容をキャンセルできます。EndEdit は編集内容を確定しますが、DataSetAcceptChanges が呼び出されるまでは実際には変更を受け入れません。また、EndEdit または CancelEdit を使用して編集を終了する前に AcceptChanges を呼び出した場合は、編集が終了し、Proposed 行値が Current 行バージョンと Original 行バージョンの両方に受け入れられます。同様に、RejectChanges を呼び出した場合も編集が終了し、Current 行バージョンと Proposed 行バージョンの両方が破棄されます。AcceptChanges または RejectChanges を呼び出した後で EndEdit または CancelEdit を呼び出しても、編集が既に終了しているため、その呼び出しは無効になります。

BeginEditEndEdit、および CancelEdit を使用する方法を次の例に示します。この例では、ColumnChanged イベントで ProposedValue をチェックして、編集をキャンセルするかどうかを決定しています。

Dim workTable As DataTable = New DataTable
workTable.Columns.Add("LastName", Type.GetType("System.String"))

AddHandler workTable.ColumnChanged, _
  New DataColumnChangeEventHandler(AddressOf OnColumnChanged)

Dim workRow As DataRow = workTable.NewRow()
workRow(0) = "Smith"
workTable.Rows.Add(workRow)

workRow.BeginEdit()
' Causes the ColumnChanged event to write a message and cancel the edit.
workRow(0) = ""     
workRow.EndEdit()

' Displays "Smith, New".
Console.WriteLine("{0}, {1}", workRow(0), workRow.RowState)  


Private Shared Sub OnColumnChanged( _
  sender As Object, args As DataColumnChangeEventArgs)
  If args.Column.ColumnName = "LastName" Then
    If args.ProposedValue.ToString() = "" Then
      Console.WriteLine("Last Name cannot be blank.  Edit canceled.")
      args.Row.CancelEdit()
    End If
  End If
End Sub
DataTable workTable  = new DataTable();
workTable.Columns.Add("LastName", typeof(String));

workTable.ColumnChanged += 
  new DataColumnChangeEventHandler(OnColumnChanged);

DataRow workRow = workTable.NewRow();
workRow[0] = "Smith";
workTable.Rows.Add(workRow);

workRow.BeginEdit();
// Causes the ColumnChanged event to write a message and cancel the edit.
workRow[0] = "";     
workRow.EndEdit();

// Displays "Smith, New".
Console.WriteLine("{0}, {1}", workRow[0], workRow.RowState);  

protected static void OnColumnChanged(
  Object sender, DataColumnChangeEventArgs args)
{
  if (args.Column.ColumnName == "LastName")
    if (args.ProposedValue.ToString() == "")
    {
      Console.WriteLine("Last Name cannot be blank. Edit canceled.");
      args.Row.CancelEdit();
    }
}

参照

概念

DataTable イベントの処理 (ADO.NET)

参照

DataRow

DataTable

DataRowVersion

その他の技術情報

DataTable 内のデータの操作