Microsoft KB Archive/316024

= HOW TO: Roll Back Updates After an Error When You Use DataAdapter and DataSet in ADO.NET and Visual C# .NET =

Article ID: 316024

Article Last Modified on 9/4/2003

-

APPLIES TO


 * Microsoft .NET Framework 1.1 Service Pack 1
 * Microsoft ADO.NET 1.1
 * Microsoft Visual C# .NET 2002 Standard Edition
 * Microsoft Visual C# .NET 2003 Standard Edition

-



This article was previously published under Q316024



For a Microsoft Visual Basic .NET version of this article, see 310351.

This article refers to the following Microsoft .NET Framework Class Library namespaces:
 * System.Data
 * System.Data.SqlClient

IN THIS TASK
SUMMARY
 * Steps to Build the Sample

REFERENCES



SUMMARY
This article describes how to roll back updates after an error when you use a DataAdapter and a DataSet object.

If your client application uses an ADO.NET DataSet object to store changes that are made to data or to add new records, you can use a Transaction object, a DataSet object, and a DataAdapter object to roll back any changes if an error occurs. If you use a CommandBuilder object to generate INSERT, UPDATE, and DELETE commands, you must set the Transaction property of the SELECT command of the DataAdapter.

If you use a wizard to generate a typed DataSet and its Command objects to populate the InsertCommand, the UpdateCommand, and the DeleteCommand properties of the DataAdapter, you must set the Transaction property for each InsertCommand, UpdateCommand, and DeleteCommand but not the SelectCommand of the DataSet.

NOTE: This article uses the CommandBuilder.

back to the top

Steps to Build the Sample
 Follow these steps to create a new Visual C# .NET Windows Application project:  Start Microsoft Visual Studio .NET. On the File menu, point to New, and then click Project. In the New Project dialog box, click Visual C# Projects under Project Types, and then click Windows Application under Templates.   In the Form class, add the following line immediately after the using statements: using System.Data.SqlClient;   Add a Button control, and then add the following code to the Click event of Button1: string stConnection = &quot;user id=YourUserID;password=YourPassword;server=YourServer;database=Northwind&quot;; SqlConnection cnNorthwind = new SqlConnection(stConnection); SqlCommand cmNorthwind = new SqlCommand(&quot;select * from employees&quot;,cnNorthwind); SqlDataAdapter daNorthwind = new SqlDataAdapter(cmNorthwind); SqlCommandBuilder cb = new SqlCommandBuilder(daNorthwind); DataSet dsNorthwind = new DataSet; DataSet dsNorthwind2 = new DataSet; daNorthwind.Fill(dsNorthwind,&quot;Employees&quot;); // Add code to change or add a record. // System.Data.DataRow dr; System.Data.DataRow dr = dsNorthwind.Tables[&quot;Employees&quot;].NewRow; dr[1] = &quot;henry&quot;; dr[2] = &quot;matthews&quot;; dsNorthwind.Tables[&quot;Employees&quot;].Rows.Add(dr); dsNorthwind2 = dsNorthwind.GetChanges; cnNorthwind.Open; System.Data.SqlClient.SqlTransaction tr; tr = cnNorthwind.BeginTransaction(IsolationLevel.ReadCommitted); daNorthwind.SelectCommand.Transaction = tr; try {       daNorthwind.Update(dsNorthwind2,&quot;Employees&quot;); tr.Commit; dsNorthwind.Merge(dsNorthwind2); MessageBox.Show(&quot;Record(s) added or Updated&quot;); }   catch (System.Exception err) {       try {       MessageBox.Show (err.ToString); tr.Rollback; }       catch (System.Exception TransactionEx) {       //Handle Exception }      }                    </li> Modify the parameter of the connection string property of the SqlConnection object as appropriate for your environment.</li> Add a DataGrid control and code to bind the grid to your DataSet if you want to view records, make changes, or add records to the DataSet.</li></ol>

back to the top

<div class="references_section">