DOC: Clear() Method Throws an Exception When DataSet Is Bound to XmlDataDocument (307511)

SUMMARY

The "DataSet.Clear Method" topic in the Microsoft .NET Framework Class Library documentation specifies that the DataSet.Clear method "clears the DataSet of any data by removing all rows in all tables."

However, when a DataSet object is bound to an XmlDataDocument object, an exception is thrown if you call the Clear method on the tables.

For example, if you use the following code:

DataSet ds = new DataSet();

//Skip. Populate the DataSet. 
// ...

//Bind the DataSet with XmlDataDocument.
XmlDataDocument docCust = new XmlDataDocument(ds);			

ds.Tables.Clear();
				

the Clear method call raises the following exception:

//row by row
foreach(DataTable dt in docCust.DataSet.Tables)
{
     int count = dt.Rows.Count; 
     for(int i=0; i<count; i++)
     {
       docCust.DataSet.Tables[dt.TableName].Rows.RemoveAt(0);
     }
}