C# in a Nutshell

Name

XmlDataDocument

Synopsis

The XmlDataDocument is a marriage of XML and RDBMS technology; it is an XmlDocument-inheriting class that particularly understands ADO.NET DataSet objects. This offers a variety of opportunities to the C# programmer—for example, a DataSet can be loaded into the XmlDataDocument, and then navigated using traditional DOM-style navigation using the XmlNode API. In fact, because XmlDataDocument also inherits the System.Xml.XPath.IXPathNavigable interface, XPath queries can be issued against the DataSet data, as well.

In order to build this relationship, construct the XmlDataDocument with the DataSet holding the data as its constructor parameter. Alternatively, use the Load() method to read in the data via an XmlReader. The resulting XML can also then be written out to another medium with the WriteTo() method.

public class XmlDataDocument : XmlDocument {
// Public Constructors
   public method XmlDataDocument();  
   public method XmlDataDocument(
        System.Data.DataSet dataset);  
// Public Instance Properties
   public field DataSet DataSet{get; } 
// Public Instance Methods
   public override method XmlNode CloneNode(bool deep);         // overrides XmlDocument
   public override method XmlElement CreateElement(             // overrides XmlDocument
        string prefix, string localName, 
        string namespaceURI);  
   public override method XmlEntityReference CreateEntityReference( // overrides XmlDocument
        string name);  
   public override method XmlElement GetElementById(            // overrides XmlDocument
        string elemId); ...