When AcceptChanges is called on the DataSet, DataTable, or DataRow, either explicitly or implicitly by calling the Update method of the DataAdapter, the following occurs: • All rows w
Trang 1[ Team LiB ]
Recipe 2.6 Accessing Deleted Rows in a DataTable
Problem
When you delete rows from a DataSet they are really marked for deletion until changes are committed by calling AcceptChanges( ) either directly or indirectly You want to access the rows that you have deleted from a DataTable
Solution
Use either a DataView or the Select( ) method of the DataTable to access deleted rows The sample code contains three event handlers:
Form.Load
Sets up the sample by creating a DataTable containing Orders data from
Northwind A view containing the Current rows is bound to a data grid on the form
Current Rows RadioButton.CheckedChanged
Sets the view of the Orders data to display only Current rows The text box
displaying information about deleted rows is cleared
Deleted Rows RadioButton.CheckedChanged
Sets the view of the Orders data to display only Deleted rows The DataTable for the DataView is retrieved and the Select( ) method is used to get the Deleted rows The overloaded indexer in C#, or Item( ) property in VB.NET, is used to retrieve the OrderID from the Original version of these deleted rows This information is displayed in the text box on the form
The C# code is shown in Example 2-6
Example 2-6 File: AccessDeletedRowsForm.cs
// Namespaces, variables, and constants
Trang 2using System;
using System.Configuration;
using System.Text;
using System.Data;
using System.Data.SqlClient;
private DataView dv;
//
private void AccessDataSetDeletedRowsForm_Load(object sender,
System.EventArgs e)
{
// Fill the Orders table
SqlDataAdapter da = new SqlDataAdapter("SELECT * FROM Orders", ConfigurationSettings.AppSettings["Sql_ConnectString"]);
DataTable dt = new DataTable("Orders");
da.Fill(dt);
// Define a view of just the Current rows
dv = new DataView(dt, null, null, DataViewRowState.CurrentRows); dataGrid.DataSource = dv;
currentRadioButton.Checked = true;
}
private void currentRadioButton_CheckedChanged(object sender,
System.EventArgs e)
{
// Filter to include only current rows
dv.RowStateFilter = DataViewRowState.CurrentRows;
dataGrid.ReadOnly = false;
deletedTextBox.Clear( );
}
private void deletedRadioButton_CheckedChanged(object sender,
System.EventArgs e)
{
// Filter the view to include only deleted rows
dv.RowStateFilter = DataViewRowState.Deleted;
dataGrid.ReadOnly = true;
Trang 3// Get the DataTable from the DataView
DataTable dt = dv.Table;
// Filter using the DataTable RowState
DataRow[] delRows = dt.Select(null, null, DataViewRowState.Deleted);
StringBuilder sb = new StringBuilder("Deleted Records:" +
Environment.NewLine);
// Iterate over the collection of deleted rows
foreach(DataRow row in delRows)
sb.Append("Order ID: " + row["OrderID",
DataRowVersion.Original] + Environment.NewLine);
deletedTextBox.Text = sb.ToString( );
}
Discussion
ADO.NET manages the state of the rows while they are being modified Rows are
assigned a state from the DataRowState enumeration described in Table 2-4
Table 2-4 DataRowState enumeration Value Description
Added The row has been added to the collection of rows in the table but
AcceptChanges( ) has not been called
Deleted The row has been deleted from the collection of rows in the table but
AcceptChanges( ) has not been called
Detached The row does not belong to the collection of rows in a DataTable
Modified The data in the row has been changed but AcceptChanges( ) has not been
called
Unchanged The data in the row has not been changed since it was loaded or since
AcceptChanges( ) was last called
When AcceptChanges( ) is called on the DataSet, DataTable, or DataRow, either
explicitly or implicitly by calling the Update( ) method of the DataAdapter, the following occurs:
• All rows with a row state of Deleted are removed
• All other rows are assigned a row state of Unchanged and the Original row version
values are overwritten with the Current version values
Trang 4When RejectChanges( ) is called on the DataSet, DataTable, or DataRow, the following
occurs:
• All rows with a row state of Added are removed
• All other rows are assigned a row state of Unchanged and the Current row version
values are overwritten with the Original row version values
Each DataRow has a RowState property that returns the current state of the row
ADO.NET maintains several versions of the data in each row while it is being modified
to allow the disconnected to be later reconciled with the data source Table 2-5 describes
the DataRowVersion enumeration values
Table 2-5 DataRowVersion enumeration Value Description
Current Current value This version does not exist for rows with a state of Deleted
Default
Default value as determined by the DataRowState:
• The Current version for rows with Added, Modified, or Unchanged state
• The Original version for rows with Deleted state
• The Proposed value for rows with Detached state
Original Original value This version does not exist for rows with a state of Added
Proposed Proposed value This value exists during a row edit operation started either
implicitly or explicitly with the BeginEdit( ) method and for Detached rows
The HasVersion( ) method of the DataRow object checks whether a particular row
version exists
The DataViewRowState enumeration is used to retrieve a particular version of data or to
determine whether a version exists It is used for this purpose by both the Select( )
method of the DataTable and by the RowStateFilter property of the DataView You can
retrieve more than one version by using a Boolean OR of DataViewRowState values
Table 2-6 describes the DataViewRowState enumeration values
Table 2-6 DataViewRowState enumeration Value Description
Added The Current version of all Added rows
Trang 5CurrentRows The Current version of all Unchanged, Added, and Modified rows
This is the default value
Deleted The Original version of all Deleted rows
ModifiedCurrent The Current version of all Modified rows
ModifiedOriginal The Original version of all Modified rows
OriginalRows The Original version of Unchanged, Modified, and Deleted rows Unchanged The Current version of all Unchanged rows
The Current version of each row is retrieved by default when accessing rows in a
DataTable or in a DataView The solution demonstrates an approach for getting Deleted rows from both a DataTable and a DataView Deleted rows include only those marked for deletion using the Delete( ) method of the DataRow or the DataView, not the
Remove( ) or RemoveAt( ) method of the DataRowCollection, which instead
immediately removes the specified DataRow from the collection
The solution demonstrates two techniques for retrieving the deleted rows:
To get the Deleted rows from the DataTable, use an overload of the Select( ) method of the DataTable to return an array of deleted DataRow objects The overload accepts an argument having a DataViewRowState enumeration value To retrieve deleted rows, pass
a value of Deleted as the argument
To get the Deleted rows from the DataView, set the RowStateFilter property of the DataView to Deleted Deleted rows are also visible, along with other rows, when you set the RowStateFilter property to ModifiedOriginal and OriginalRows
[ Team LiB ]
[ Team LiB ]
Recipe 2.6 Accessing Deleted Rows in a DataTable
Trang 6Problem
When you delete rows from a DataSet they are really marked for deletion until changes are committed by calling AcceptChanges( ) either directly or indirectly You want to access the rows that you have deleted from a DataTable
Solution
Use either a DataView or the Select( ) method of the DataTable to access deleted rows The sample code contains three event handlers:
Form.Load
Sets up the sample by creating a DataTable containing Orders data from
Northwind A view containing the Current rows is bound to a data grid on the form
Current Rows RadioButton.CheckedChanged
Sets the view of the Orders data to display only Current rows The text box
displaying information about deleted rows is cleared
Deleted Rows RadioButton.CheckedChanged
Sets the view of the Orders data to display only Deleted rows The DataTable for the DataView is retrieved and the Select( ) method is used to get the Deleted rows The overloaded indexer in C#, or Item( ) property in VB.NET, is used to retrieve the OrderID from the Original version of these deleted rows This information is displayed in the text box on the form
The C# code is shown in Example 2-6
Example 2-6 File: AccessDeletedRowsForm.cs
// Namespaces, variables, and constants
using System;
using System.Configuration;
using System.Text;
using System.Data;
using System.Data.SqlClient;
private DataView dv;
Trang 7//
private void AccessDataSetDeletedRowsForm_Load(object sender,
System.EventArgs e)
{
// Fill the Orders table
SqlDataAdapter da = new SqlDataAdapter("SELECT * FROM Orders", ConfigurationSettings.AppSettings["Sql_ConnectString"]);
DataTable dt = new DataTable("Orders");
da.Fill(dt);
// Define a view of just the Current rows
dv = new DataView(dt, null, null, DataViewRowState.CurrentRows); dataGrid.DataSource = dv;
currentRadioButton.Checked = true;
}
private void currentRadioButton_CheckedChanged(object sender,
System.EventArgs e)
{
// Filter to include only current rows
dv.RowStateFilter = DataViewRowState.CurrentRows;
dataGrid.ReadOnly = false;
deletedTextBox.Clear( );
}
private void deletedRadioButton_CheckedChanged(object sender,
System.EventArgs e)
{
// Filter the view to include only deleted rows
dv.RowStateFilter = DataViewRowState.Deleted;
dataGrid.ReadOnly = true;
// Get the DataTable from the DataView
DataTable dt = dv.Table;
// Filter using the DataTable RowState
DataRow[] delRows = dt.Select(null, null, DataViewRowState.Deleted);
StringBuilder sb = new StringBuilder("Deleted Records:" +
Environment.NewLine);
// Iterate over the collection of deleted rows
Trang 8foreach(DataRow row in delRows)
sb.Append("Order ID: " + row["OrderID",
DataRowVersion.Original] + Environment.NewLine);
deletedTextBox.Text = sb.ToString( );
}
Discussion
ADO.NET manages the state of the rows while they are being modified Rows are
assigned a state from the DataRowState enumeration described in Table 2-4
Table 2-4 DataRowState enumeration Value Description
Added The row has been added to the collection of rows in the table but
AcceptChanges( ) has not been called
Deleted The row has been deleted from the collection of rows in the table but
AcceptChanges( ) has not been called
Detached The row does not belong to the collection of rows in a DataTable
Modified The data in the row has been changed but AcceptChanges( ) has not been
called
Unchanged The data in the row has not been changed since it was loaded or since
AcceptChanges( ) was last called
When AcceptChanges( ) is called on the DataSet, DataTable, or DataRow, either
explicitly or implicitly by calling the Update( ) method of the DataAdapter, the following occurs:
• All rows with a row state of Deleted are removed
• All other rows are assigned a row state of Unchanged and the Original row version
values are overwritten with the Current version values
When RejectChanges( ) is called on the DataSet, DataTable, or DataRow, the following occurs:
• All rows with a row state of Added are removed
• All other rows are assigned a row state of Unchanged and the Current row version
values are overwritten with the Original row version values
Trang 9Each DataRow has a RowState property that returns the current state of the row
ADO.NET maintains several versions of the data in each row while it is being modified
to allow the disconnected to be later reconciled with the data source Table 2-5 describes
the DataRowVersion enumeration values
Table 2-5 DataRowVersion enumeration Value Description
Current Current value This version does not exist for rows with a state of Deleted
Default
Default value as determined by the DataRowState:
• The Current version for rows with Added, Modified, or Unchanged state
• The Original version for rows with Deleted state
• The Proposed value for rows with Detached state
Original Original value This version does not exist for rows with a state of Added
Proposed Proposed value This value exists during a row edit operation started either
implicitly or explicitly with the BeginEdit( ) method and for Detached rows
The HasVersion( ) method of the DataRow object checks whether a particular row
version exists
The DataViewRowState enumeration is used to retrieve a particular version of data or to
determine whether a version exists It is used for this purpose by both the Select( )
method of the DataTable and by the RowStateFilter property of the DataView You can
retrieve more than one version by using a Boolean OR of DataViewRowState values
Table 2-6 describes the DataViewRowState enumeration values
Table 2-6 DataViewRowState enumeration Value Description
Added The Current version of all Added rows
CurrentRows The Current version of all Unchanged, Added, and Modified rows
This is the default value
Deleted The Original version of all Deleted rows
ModifiedCurrent The Current version of all Modified rows
ModifiedOriginal The Original version of all Modified rows
Trang 10None No rows
OriginalRows The Original version of Unchanged, Modified, and Deleted rows Unchanged The Current version of all Unchanged rows
The Current version of each row is retrieved by default when accessing rows in a
DataTable or in a DataView The solution demonstrates an approach for getting Deleted rows from both a DataTable and a DataView Deleted rows include only those marked for deletion using the Delete( ) method of the DataRow or the DataView, not the
Remove( ) or RemoveAt( ) method of the DataRowCollection, which instead
immediately removes the specified DataRow from the collection
The solution demonstrates two techniques for retrieving the deleted rows:
To get the Deleted rows from the DataTable, use an overload of the Select( ) method of the DataTable to return an array of deleted DataRow objects The overload accepts an argument having a DataViewRowState enumeration value To retrieve deleted rows, pass
a value of Deleted as the argument
To get the Deleted rows from the DataView, set the RowStateFilter property of the DataView to Deleted Deleted rows are also visible, along with other rows, when you set the RowStateFilter property to ModifiedOriginal and OriginalRows
[ Team LiB ]