mcs/class/System.Data/Documentation/en/System.Xml/XmlDataDocument.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <Type Name="XmlDataDocument" FullName="System.Xml.XmlDataDocument">
   3   <TypeSignature Language="C#" Maintainer="auto" Value="public class XmlDataDocument : System.Xml.XmlDocument" />
   4   <AssemblyInfo>
   5     <AssemblyName>System.Data</AssemblyName>
   6     <AssemblyPublicKey>[00 00 00 00 00 00 00 00 04 00 00 00 00 00 00 00]</AssemblyPublicKey>
   7     <AssemblyVersion>1.0.3300.0</AssemblyVersion>
   8     <AssemblyVersion>1.0.5000.0</AssemblyVersion>
   9     <AssemblyVersion>2.0.0.0</AssemblyVersion>
  10   </AssemblyInfo>
  11   <ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the &lt;link location="node:gtk-sharp/programming/threads"&gt;Gtk# Thread Programming&lt;/link&gt; for details.</ThreadSafetyStatement>
  12   <Base>
  13     <BaseTypeName>System.Xml.XmlDocument</BaseTypeName>
  14   </Base>
  15   <Interfaces>
  16   </Interfaces>
  17   <Docs>
  18     <remarks>
  19       <attribution license="cc4" from="Microsoft" modified="false" />
  20       <para>This class extends <see cref="T:System.Xml.XmlDocument" />. It enables you to load either relational data or XML data and manipulate that data using the World Wide Web Consortium (W3C) Document Object Model (DOM). The DOM presents data as a hierarchy of node objects. Because XmlDataDocument implements the <see cref="T:System.Xml.XPath.IXPathNavigable" /> interface, it can also be used as the source document for the <see cref="T:System.Xml.Xsl.XslTransform" /> class.</para>
  21       <para>XmlDataDocument has a close affiliation with the DataSet class, which provides a relational view of the loaded XML data. Any changes made to the XmlDataDocument are reflected in the DataSet and vice versa.</para>
  22       <para>To load a DataSet with XML data, use <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> to build a relational mapping. The XML data can then be loaded using <see cref="M:System.Xml.XmlDataDocument.Load(System.String)" /> or <see cref="M:System.Xml.XmlDocument.LoadXml(System.String)" />.</para>
  23       <para>To load relational data, specify the DataSet containing the relational data as the parameter in the <see cref="M:System.Xml.XmlDataDocument.#ctor" /> constructor.</para>
  24     </remarks>
  25     <summary>
  26       <attribution license="cc4" from="Microsoft" modified="false" />
  27       <para>Allows structured data to be stored, retrieved, and manipulated through a relational <see cref="T:System.Data.DataSet" />. </para>
  28     </summary>
  29   </Docs>
  30   <Members>
  31     <Member MemberName=".ctor">
  32       <MemberSignature Language="C#" Value="public XmlDataDocument ();" />
  33       <MemberType>Constructor</MemberType>
  34       <ReturnValue />
  35       <Parameters />
  36       <Docs>
  37         <remarks>
  38           <attribution license="cc4" from="Microsoft" modified="false" />
  39           <para>An empty <see cref="T:System.Data.DataSet" /> is created and associated with the XmlDataDocument.</para>
  40         </remarks>
  41         <summary>
  42           <attribution license="cc4" from="Microsoft" modified="false" />
  43           <para>Initializes a new instance of the <see cref="T:System.Xml.XmlDataDocument" /> class.</para>
  44         </summary>
  45       </Docs>
  46       <AssemblyInfo>
  47         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  48         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  49       </AssemblyInfo>
  50     </Member>
  51     <Member MemberName=".ctor">
  52       <MemberSignature Language="C#" Value="public XmlDataDocument (System.Data.DataSet dataset);" />
  53       <MemberType>Constructor</MemberType>
  54       <ReturnValue />
  55       <Parameters>
  56         <Parameter Name="dataset" Type="System.Data.DataSet" />
  57       </Parameters>
  58       <Docs>
  59         <remarks>
  60           <attribution license="cc4" from="Microsoft" modified="false" />
  61           <para>The XmlDataDocument is synchronized with the specified DataSet. Any data in the DataSet is immediately available through the XmlDataDocument. Any changes in the DataSet are propagated in the XmlDataDocument. Any changes made in the XmlDataDocument, provided they match the DataSet schema, are propagated in the DataSet.</para>
  62         </remarks>
  63         <summary>
  64           <attribution license="cc4" from="Microsoft" modified="false" />
  65           <para>Initializes a new instance of the <see cref="T:System.Xml.XmlDataDocument" /> class with the specified <see cref="T:System.Data.DataSet" />.</para>
  66         </summary>
  67         <param name="dataset">
  68           <attribution license="cc4" from="Microsoft" modified="false" />The DataSet to load into XmlDataDocument. </param>
  69       </Docs>
  70       <AssemblyInfo>
  71         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
  72         <AssemblyVersion>2.0.0.0</AssemblyVersion>
  73       </AssemblyInfo>
  74     </Member>
  75     <Member MemberName="CloneNode">
  76       <MemberSignature Language="C#" Value="public override System.Xml.XmlNode CloneNode (bool deep);" />
  77       <MemberType>Method</MemberType>
  78       <ReturnValue>
  79         <ReturnType>System.Xml.XmlNode</ReturnType>
  80       </ReturnValue>
  81       <Parameters>
  82         <Parameter Name="deep" Type="System.Boolean" />
  83       </Parameters>
  84       <Docs>
  85         <remarks>
  86           <attribution license="cc4" from="Microsoft" modified="false" />
  87           <para>Cloning the XmlDataDocument also clones the <see cref="T:System.Data.DataSet" /> schema.</para>
  88           <para>If <paramref name="deep" /> is set to false, the cloned DataSet has no data; that is, no rows.</para>
  89           <para>If <paramref name="deep" /> is set to true, the cloned DataSet is set with the schema and then populated with the data.</para>
  90           <para>See <see cref="M:System.Xml.XmlNode.CloneNode(System.Boolean)" /> in the XmlNode class to see a table describing how this method behaves with each of the different node types.</para>
  91         </remarks>
  92         <summary>
  93           <attribution license="cc4" from="Microsoft" modified="false" />
  94           <para>Creates a duplicate of the current node.</para>
  95         </summary>
  96         <returns>
  97           <attribution license="cc4" from="Microsoft" modified="false" />
  98           <para>The cloned node.</para>
  99         </returns>
 100         <param name="deep">
 101           <attribution license="cc4" from="Microsoft" modified="false" />true to recursively clone the subtree under the specified node; false to clone only the node itself. </param>
 102       </Docs>
 103       <AssemblyInfo>
 104         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 105         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 106       </AssemblyInfo>
 107     </Member>
 108     <Member MemberName="CreateElement">
 109       <MemberSignature Language="C#" Value="public override System.Xml.XmlElement CreateElement (string prefix, string localName, string namespaceURI);" />
 110       <MemberType>Method</MemberType>
 111       <ReturnValue>
 112         <ReturnType>System.Xml.XmlElement</ReturnType>
 113       </ReturnValue>
 114       <Parameters>
 115         <Parameter Name="prefix" Type="System.String" />
 116         <Parameter Name="localName" Type="System.String" />
 117         <Parameter Name="namespaceURI" Type="System.String" />
 118       </Parameters>
 119       <Docs>
 120         <remarks>
 121           <attribution license="cc4" from="Microsoft" modified="false" />
 122           <para>Note to Inheritors If you overload this function, it cannot be used for extensibility. Instead, you can return an element created by the base class, in this case, XmlDataDocument. See the following example.</para>
 123           <code> class MyXmlDataDocument : XmlDataDocument {
 124   public override XmlElement CreateElement(string prefix, string localName, string nsURI) {
 125     //Ensure we are returning the base class implementation of element.
 126     XmlElement e = base.CreateElement(prefix, localName, nsURI);
 127     //Add additional code here.
 128     return e;    //Return the element created by XmlDataDocument.
 129   }
 130  }</code>
 131         </remarks>
 132         <summary>
 133           <attribution license="cc4" from="Microsoft" modified="false" />
 134           <para>Creates an element with the specified <see cref="P:System.Xml.XmlNode.Prefix" />, <see cref="P:System.Xml.XmlDocument.LocalName" /> , and <see cref="P:System.Xml.XmlNode.NamespaceURI" />.</para>
 135         </summary>
 136         <returns>
 137           <attribution license="cc4" from="Microsoft" modified="false" />
 138           <para>A new <see cref="T:System.Xml.XmlElement" />.</para>
 139         </returns>
 140         <param name="prefix">
 141           <attribution license="cc4" from="Microsoft" modified="false" />The prefix of the new element. If String.Empty or null, there is no prefix. </param>
 142         <param name="localName">
 143           <attribution license="cc4" from="Microsoft" modified="false" />The local name of the new element. </param>
 144         <param name="namespaceURI">
 145           <attribution license="cc4" from="Microsoft" modified="false" />The namespace Uniform Resource Identifier (URI) of the new element. If String.Empty or null, there is no namespaceURI. </param>
 146       </Docs>
 147       <AssemblyInfo>
 148         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 149         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 150       </AssemblyInfo>
 151     </Member>
 152     <Member MemberName="CreateEntityReference">
 153       <MemberSignature Language="C#" Value="public override System.Xml.XmlEntityReference CreateEntityReference (string name);" />
 154       <MemberType>Method</MemberType>
 155       <ReturnValue>
 156         <ReturnType>System.Xml.XmlEntityReference</ReturnType>
 157       </ReturnValue>
 158       <Parameters>
 159         <Parameter Name="name" Type="System.String" />
 160       </Parameters>
 161       <Docs>
 162         <remarks>
 163           <attribution license="cc4" from="Microsoft" modified="false" />
 164           <para>
 165             <see cref="T:System.Xml.XmlEntityReference" /> nodes cannot be created for <see cref="T:System.Xml.XmlDataDocument" /> objects. Calling this method throws an exception.</para>
 166         </remarks>
 167         <summary>
 168           <attribution license="cc4" from="Microsoft" modified="false" />
 169           <para>Creates an <see cref="T:System.Xml.XmlEntityReference" /> with the specified name.</para>
 170         </summary>
 171         <returns>
 172           <attribution license="cc4" from="Microsoft" modified="false" />
 173           <para>An <see cref="T:System.Xml.XmlEntityReference" /> with the specified name.</para>
 174         </returns>
 175         <param name="name">
 176           <attribution license="cc4" from="Microsoft" modified="false" />The name of the entity reference.</param>
 177       </Docs>
 178       <AssemblyInfo>
 179         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 180         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 181       </AssemblyInfo>
 182     </Member>
 183     <Member MemberName="CreateNavigator">
 184       <MemberSignature Language="C#" Value="protected override System.Xml.XPath.XPathNavigator CreateNavigator (System.Xml.XmlNode node);" />
 185       <MemberType>Method</MemberType>
 186       <ReturnValue>
 187         <ReturnType>System.Xml.XPath.XPathNavigator</ReturnType>
 188       </ReturnValue>
 189       <Parameters>
 190         <Parameter Name="node" Type="System.Xml.XmlNode" />
 191       </Parameters>
 192       <Docs>
 193         <remarks>
 194           <attribution license="cc4" from="Microsoft" modified="false" />
 195           <para>The XPathNavigator provides read-only, random access to data. Because it is optimized for XSLT transformations, it provides performance benefits when used as an input mechanism to the <see cref="M:System.Xml.Xsl.XslTransform.Transform(System.Xml.XPath.XPathNavigator,System.Xml.Xsl.XsltArgumentList,System.Xml.XmlResolver)" /> method.</para>
 196         </remarks>
 197         <summary>
 198           <attribution license="cc4" from="Microsoft" modified="false" />
 199           <para>Creates a new <see cref="T:System.Xml.XPath.XPathNavigator" /> object for navigating this document. The XPathNavigator is positioned on the node specified in the <paramref name="node" /> parameter.</para>
 200         </summary>
 201         <returns>
 202           <attribution license="cc4" from="Microsoft" modified="false" />
 203           <para>An XPathNavigator used to navigate the document.</para>
 204         </returns>
 205         <param name="node">
 206           <attribution license="cc4" from="Microsoft" modified="false" />The <see cref="T:System.Xml.XmlNode" /> you want the navigator initially positioned on. </param>
 207       </Docs>
 208       <AssemblyInfo>
 209         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 210         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 211       </AssemblyInfo>
 212     </Member>
 213     <Member MemberName="DataSet">
 214       <MemberSignature Language="C#" Value="public System.Data.DataSet DataSet { get; }" />
 215       <MemberType>Property</MemberType>
 216       <ReturnValue>
 217         <ReturnType>System.Data.DataSet</ReturnType>
 218       </ReturnValue>
 219       <Docs>
 220         <value>To be added: an object of type 'Data.DataSet'</value>
 221         <remarks>
 222           <attribution license="cc4" from="Microsoft" modified="false" />
 223           <para>The DataSet enables you to access the data in the XmlDataDocument using a relational model. This means that you can handle the data as tables and views, rows and columns, relations, and so on. Changes made in the DataSet are immediately visible in the XmlDataDocument.</para>
 224         </remarks>
 225         <summary>
 226           <attribution license="cc4" from="Microsoft" modified="false" />
 227           <para>Gets a <see cref="T:System.Data.DataSet" /> that provides a relational representation of the data in the XmlDataDocument.</para>
 228         </summary>
 229       </Docs>
 230       <AssemblyInfo>
 231         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 232         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 233       </AssemblyInfo>
 234     </Member>
 235     <Member MemberName="GetElementById">
 236       <MemberSignature Language="C#" Value="public override System.Xml.XmlElement GetElementById (string elemId);" />
 237       <MemberType>Method</MemberType>
 238       <ReturnValue>
 239         <ReturnType>System.Xml.XmlElement</ReturnType>
 240       </ReturnValue>
 241       <Parameters>
 242         <Parameter Name="elemId" Type="System.String" />
 243       </Parameters>
 244       <Docs>
 245         <remarks>
 246           <attribution license="cc4" from="Microsoft" modified="false" />
 247           <para>This method is not supported by the <see cref="T:System.Xml.XmlDataDocument" /> class.</para>
 248         </remarks>
 249         <summary>
 250           <attribution license="cc4" from="Microsoft" modified="false" />
 251           <para>Gets the <see cref="T:System.Xml.XmlElement" /> with the specified ID. This method is not supported by the <see cref="T:System.Xml.XmlDataDocument" /> class. Calling this method throws an exception.</para>
 252         </summary>
 253         <returns>
 254           <attribution license="cc4" from="Microsoft" modified="false" />
 255           <para>An <see cref="T:System.Xml.XmlElement" /> with the specified ID.</para>
 256         </returns>
 257         <param name="elemId">
 258           <attribution license="cc4" from="Microsoft" modified="false" />The attribute ID to match.</param>
 259       </Docs>
 260       <AssemblyInfo>
 261         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 262         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 263       </AssemblyInfo>
 264     </Member>
 265     <Member MemberName="GetElementFromRow">
 266       <MemberSignature Language="C#" Value="public System.Xml.XmlElement GetElementFromRow (System.Data.DataRow r);" />
 267       <MemberType>Method</MemberType>
 268       <ReturnValue>
 269         <ReturnType>System.Xml.XmlElement</ReturnType>
 270       </ReturnValue>
 271       <Parameters>
 272         <Parameter Name="r" Type="System.Data.DataRow" />
 273       </Parameters>
 274       <Docs>
 275         <remarks>To be added</remarks>
 276         <summary>
 277           <attribution license="cc4" from="Microsoft" modified="false" />
 278           <para>Retrieves the <see cref="T:System.Xml.XmlElement" /> associated with the specified <see cref="T:System.Data.DataRow" />.</para>
 279         </summary>
 280         <returns>
 281           <attribution license="cc4" from="Microsoft" modified="false" />
 282           <para>The XmlElement containing a representation of the specified DataRow.</para>
 283         </returns>
 284         <param name="r">
 285           <attribution license="cc4" from="Microsoft" modified="false" />The DataRow whose associated XmlElement you want to retrieve. </param>
 286       </Docs>
 287       <AssemblyInfo>
 288         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 289         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 290       </AssemblyInfo>
 291     </Member>
 292     <Member MemberName="GetRowFromElement">
 293       <MemberSignature Language="C#" Value="public System.Data.DataRow GetRowFromElement (System.Xml.XmlElement e);" />
 294       <MemberType>Method</MemberType>
 295       <ReturnValue>
 296         <ReturnType>System.Data.DataRow</ReturnType>
 297       </ReturnValue>
 298       <Parameters>
 299         <Parameter Name="e" Type="System.Xml.XmlElement" />
 300       </Parameters>
 301       <Docs>
 302         <remarks>To be added</remarks>
 303         <summary>
 304           <attribution license="cc4" from="Microsoft" modified="false" />
 305           <para>Retrieves the <see cref="T:System.Data.DataRow" /> associated with the specified <see cref="T:System.Xml.XmlElement" />.</para>
 306         </summary>
 307         <returns>
 308           <attribution license="cc4" from="Microsoft" modified="false" />
 309           <para>The DataRow containing a representation of the XmlElement; null if there is no DataRow associated with the XmlElement.</para>
 310         </returns>
 311         <param name="e">
 312           <attribution license="cc4" from="Microsoft" modified="false" />The XmlElement whose associated DataRow you want to retrieve. </param>
 313       </Docs>
 314       <AssemblyInfo>
 315         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 316         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 317       </AssemblyInfo>
 318     </Member>
 319     <Member MemberName="Load">
 320       <MemberSignature Language="C#" Value="public override void Load (System.IO.Stream inStream);" />
 321       <MemberType>Method</MemberType>
 322       <ReturnValue>
 323         <ReturnType>System.Void</ReturnType>
 324       </ReturnValue>
 325       <Parameters>
 326         <Parameter Name="inStream" Type="System.IO.Stream" />
 327       </Parameters>
 328       <Docs>
 329         <remarks>
 330           <attribution license="cc4" from="Microsoft" modified="false" />
 331           <para>XmlDataDocument does not support creating entity references. If the data includes entity references, the Load method resolves and expands any entity references.</para>
 332           <block subset="none" type="note">
 333             <para>In order to view the XML data relationally, you must first specify a schema to use for data mapping. This can be done either by calling the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method or by creating the tables and columns within the DataSet manually. This step must be done before calling Load.</para>
 334           </block>
 335         </remarks>
 336         <summary>
 337           <attribution license="cc4" from="Microsoft" modified="false" />
 338           <para>Loads the XmlDataDocument from the specified stream.</para>
 339         </summary>
 340         <param name="inStream">
 341           <attribution license="cc4" from="Microsoft" modified="false" />The stream containing the XML document to load. </param>
 342       </Docs>
 343       <AssemblyInfo>
 344         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 345         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 346       </AssemblyInfo>
 347     </Member>
 348     <Member MemberName="Load">
 349       <MemberSignature Language="C#" Value="public override void Load (System.IO.TextReader txtReader);" />
 350       <MemberType>Method</MemberType>
 351       <ReturnValue>
 352         <ReturnType>System.Void</ReturnType>
 353       </ReturnValue>
 354       <Parameters>
 355         <Parameter Name="txtReader" Type="System.IO.TextReader" />
 356       </Parameters>
 357       <Docs>
 358         <remarks>
 359           <attribution license="cc4" from="Microsoft" modified="false" />
 360           <para>XmlDataDocument does not support creating entity references. If the data includes entity references, the Load method resolves and expands any entity references.</para>
 361           <block subset="none" type="note">
 362             <para>In order to view the XML data relationally, you must first specify a schema to use for data mapping. This can be done either by calling the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method or by creating the tables and columns within the DataSet manually. This step must be done before calling Load.</para>
 363           </block>
 364         </remarks>
 365         <summary>
 366           <attribution license="cc4" from="Microsoft" modified="false" />
 367           <para>Loads the XmlDataDocument from the specified <see cref="T:System.IO.TextReader" />.</para>
 368         </summary>
 369         <param name="txtReader">
 370           <attribution license="cc4" from="Microsoft" modified="false" />The TextReader used to feed the XML data into the document. </param>
 371       </Docs>
 372       <AssemblyInfo>
 373         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 374         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 375       </AssemblyInfo>
 376     </Member>
 377     <Member MemberName="Load">
 378       <MemberSignature Language="C#" Value="public override void Load (string filename);" />
 379       <MemberType>Method</MemberType>
 380       <ReturnValue>
 381         <ReturnType>System.Void</ReturnType>
 382       </ReturnValue>
 383       <Parameters>
 384         <Parameter Name="filename" Type="System.String" />
 385       </Parameters>
 386       <Docs>
 387         <remarks>
 388           <attribution license="cc4" from="Microsoft" modified="false" />
 389           <para>XmlDataDocument does not support creating entity references. If the data includes entity references, the Load method resolves and expands any entity references.</para>
 390           <block subset="none" type="note">
 391             <para>In order to view the XML data relationally, you must first specify a schema to use for data mapping. This can be done either by calling the <see cref="M:System.Data.DataSet.ReadXmlSchema(System.Xml.XmlReader)" /> method or by creating the tables and columns within the DataSet manually. This step must be done before calling Load.</para>
 392           </block>
 393         </remarks>
 394         <summary>
 395           <attribution license="cc4" from="Microsoft" modified="false" />
 396           <para>Loads the XmlDataDocument using the specified URL.</para>
 397         </summary>
 398         <param name="filename">
 399           <attribution license="cc4" from="Microsoft" modified="false" />The URL of the file containing the XML document to load. </param>
 400       </Docs>
 401       <AssemblyInfo>
 402         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 403         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 404       </AssemblyInfo>
 405     </Member>
 406     <Member MemberName="Load">
 407       <MemberSignature Language="C#" Value="public override void Load (System.Xml.XmlReader reader);" />
 408       <MemberType>Method</MemberType>
 409       <ReturnValue>
 410         <ReturnType>System.Void</ReturnType>
 411       </ReturnValue>
 412       <Parameters>
 413         <Parameter Name="reader" Type="System.Xml.XmlReader" />
 414       </Parameters>
 415       <Docs>
 416         <remarks>
 417           <attribution license="cc4" from="Microsoft" modified="false" />
 418           <para>XmlDataDocument does not support creating entity references. If the data source contains entity references, you must create an <see cref="T:System.Xml.XmlValidatingReader" /> with the <see cref="P:System.Xml.XmlValidatingReader.EntityHandling" /> property set to EntityHandling.ExpandEntities (this is the default behavior) and pass the XmlValidatingReader to the Load method. If you do not use an XmlValidatingReader, the Load method throws an exception.</para>
 419           <para>The Load method always preserves significant white space. The <see cref="P:System.Xml.XmlDocument.PreserveWhitespace" /> property determines whether or not white space is preserved. The default is false, white space is not preserved.</para>
 420           <para>If the reader is in the initial state (that is, ReadState=ReadState.Initial), Load consumes the entire contents of the reader and builds the DOM from what it finds.</para>
 421           <para>If the reader is already positioned on some node at depth "n", then this method loads that node and all subsequent siblings up to the end tag that closes depth "n". This has the following results.</para>
 422           <para>If the current node and its following siblings look similar to the following: </para>
 423           <code>&lt;!--comment--&gt;&lt;element1&gt;one&lt;/element1&gt;&lt;element2&gt;two&lt;/element2&gt;</code>
 424           <para>Load throws an exception, because a document cannot have two root-level elements. If the current node and its following siblings look similar to the following: </para>
 425           <code>&lt;!--comment--&gt;&lt;?process
 426     instruction?&gt;&lt;!--comment--&gt;&lt;/endtag&gt;</code>
 427           <para>Load will succeed; however, you will have an incomplete DOM tree, because there is no root-level element. You have to add a root-level element before you save the document; otherwise, the <see cref="M:System.Xml.XmlDocument.Save(System.String)" /> method throws an exception.</para>
 428           <para>If the reader is positioned on a leaf node that is invalid for the root level of a document (for example, a white space or attribute node), the reader continues to read until it is positioned on a node that can be used for the root. The document begins loading at this point.</para>
 429         </remarks>
 430         <summary>
 431           <attribution license="cc4" from="Microsoft" modified="false" />
 432           <para>Loads the XmlDataDocument from the specified <see cref="T:System.Xml.XmlReader" />.</para>
 433         </summary>
 434         <param name="reader">
 435           <attribution license="cc4" from="Microsoft" modified="false" />The XmlReader containing the XML document to load.</param>
 436       </Docs>
 437       <AssemblyInfo>
 438         <AssemblyVersion>1.0.5000.0</AssemblyVersion>
 439         <AssemblyVersion>2.0.0.0</AssemblyVersion>
 440       </AssemblyInfo>
 441     </Member>
 442   </Members>
 443 </Type>