XmlDataDocument XmlDataDocument XmlDataDocument XmlDataDocument Class

Definition

Warning

This API is now obsolete.

Allows structured data to be stored, retrieved, and manipulated through a relational DataSet.

public ref class XmlDataDocument : System::Xml::XmlDocument
[System.Obsolete("XmlDataDocument class will be removed in a future release.")]
public class XmlDataDocument : System.Xml.XmlDocument
type XmlDataDocument = class
    inherit XmlDocument
Public Class XmlDataDocument
Inherits XmlDocument
Inheritance
Attributes

Remarks

This class extends 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 IXPathNavigable interface, it can also be used as the source document for the XslTransform class.

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.

To load a DataSet with XML data, use ReadXmlSchema to build a relational mapping. The XML data can then be loaded using Load or LoadXml.

To load relational data, specify the DataSet containing the relational data as the parameter in the XmlDataDocument constructor.

Constructors

XmlDataDocument() XmlDataDocument() XmlDataDocument() XmlDataDocument()

Initializes a new instance of the XmlDataDocument class.

XmlDataDocument(DataSet) XmlDataDocument(DataSet) XmlDataDocument(DataSet) XmlDataDocument(DataSet)

Initializes a new instance of the XmlDataDocument class with the specified DataSet.

Properties

Attributes Attributes Attributes Attributes

Gets an XmlAttributeCollection containing the attributes of this node.

(Inherited from XmlNode)
BaseURI BaseURI BaseURI BaseURI

Gets the base URI of the current node.

(Inherited from XmlDocument)
ChildNodes ChildNodes ChildNodes ChildNodes

Gets all the child nodes of the node.

(Inherited from XmlNode)
DataSet DataSet DataSet DataSet

Gets a DataSet that provides a relational representation of the data in the XmlDataDocument.

DocumentElement DocumentElement DocumentElement DocumentElement

Gets the root XmlElement for the document.

(Inherited from XmlDocument)
DocumentType DocumentType DocumentType DocumentType

Gets the node containing the DOCTYPE declaration.

(Inherited from XmlDocument)
FirstChild FirstChild FirstChild FirstChild

Gets the first child of the node.

(Inherited from XmlNode)
HasChildNodes HasChildNodes HasChildNodes HasChildNodes

Gets a value indicating whether this node has any child nodes.

(Inherited from XmlNode)
Implementation Implementation Implementation Implementation

Gets the XmlImplementation object for the current document.

(Inherited from XmlDocument)
InnerText InnerText InnerText InnerText

Throws an InvalidOperationException in all cases.

(Inherited from XmlDocument)
InnerXml InnerXml InnerXml InnerXml

Gets or sets the markup representing the children of the current node.

(Inherited from XmlDocument)
IsReadOnly IsReadOnly IsReadOnly IsReadOnly

Gets a value indicating whether the current node is read-only.

(Inherited from XmlDocument)
Item[String, String] Item[String, String] Item[String, String] Item[String, String]

Gets the first child element with the specified LocalName and NamespaceURI.

(Inherited from XmlNode)
Item[String] Item[String] Item[String] Item[String]

Gets the first child element with the specified Name.

(Inherited from XmlNode)
LastChild LastChild LastChild LastChild

Gets the last child of the node.

(Inherited from XmlNode)
LocalName LocalName LocalName LocalName

Gets the local name of the node.

(Inherited from XmlDocument)
Name Name Name Name

Gets the qualified name of the node.

(Inherited from XmlDocument)
NamespaceURI NamespaceURI NamespaceURI NamespaceURI

Gets the namespace URI of this node.

(Inherited from XmlNode)
NameTable NameTable NameTable NameTable

Gets the XmlNameTable associated with this implementation.

(Inherited from XmlDocument)
NextSibling NextSibling NextSibling NextSibling

Gets the node immediately following this node.

(Inherited from XmlNode)
NodeType NodeType NodeType NodeType

Gets the type of the current node.

(Inherited from XmlDocument)
OuterXml OuterXml OuterXml OuterXml

Gets the markup containing this node and all its child nodes.

(Inherited from XmlNode)
OwnerDocument OwnerDocument OwnerDocument OwnerDocument

Gets the XmlDocument to which the current node belongs.

(Inherited from XmlDocument)
ParentNode ParentNode ParentNode ParentNode

Gets the parent node of this node (for nodes that can have parents).

(Inherited from XmlDocument)
Prefix Prefix Prefix Prefix

Gets or sets the namespace prefix of this node.

(Inherited from XmlNode)
PreserveWhitespace PreserveWhitespace PreserveWhitespace PreserveWhitespace

Gets or sets a value indicating whether to preserve white space in element content.

(Inherited from XmlDocument)
PreviousSibling PreviousSibling PreviousSibling PreviousSibling

Gets the node immediately preceding this node.

(Inherited from XmlNode)
PreviousText PreviousText PreviousText PreviousText

Gets the text node that immediately precedes this node.

(Inherited from XmlNode)
SchemaInfo SchemaInfo SchemaInfo SchemaInfo

Returns the Post-Schema-Validation-Infoset (PSVI) of the node.

(Inherited from XmlDocument)
Schemas Schemas Schemas Schemas

Gets or sets the XmlSchemaSet object associated with this XmlDocument.

(Inherited from XmlDocument)
Value Value Value Value

Gets or sets the value of the node.

(Inherited from XmlNode)
XmlResolver XmlResolver XmlResolver XmlResolver

Sets the XmlResolver to use for resolving external resources.

(Inherited from XmlDocument)

Methods

AppendChild(XmlNode) AppendChild(XmlNode) AppendChild(XmlNode) AppendChild(XmlNode)

Adds the specified node to the end of the list of child nodes, of this node.

(Inherited from XmlNode)
Clone() Clone() Clone() Clone()

Creates a duplicate of this node.

(Inherited from XmlNode)
CloneNode(Boolean) CloneNode(Boolean) CloneNode(Boolean) CloneNode(Boolean)

Creates a duplicate of the current node.

CreateAttribute(String) CreateAttribute(String) CreateAttribute(String) CreateAttribute(String)

Creates an XmlAttribute with the specified Name.

(Inherited from XmlDocument)
CreateAttribute(String, String) CreateAttribute(String, String) CreateAttribute(String, String) CreateAttribute(String, String)

Creates an XmlAttribute with the specified qualified name and NamespaceURI.

(Inherited from XmlDocument)
CreateAttribute(String, String, String) CreateAttribute(String, String, String) CreateAttribute(String, String, String) CreateAttribute(String, String, String)

Creates an XmlAttribute with the specified Prefix, LocalName, and NamespaceURI.

(Inherited from XmlDocument)
CreateCDataSection(String) CreateCDataSection(String) CreateCDataSection(String) CreateCDataSection(String)

Creates an XmlCDataSection containing the specified data.

(Inherited from XmlDocument)
CreateComment(String) CreateComment(String) CreateComment(String) CreateComment(String)

Creates an XmlComment containing the specified data.

(Inherited from XmlDocument)
CreateDefaultAttribute(String, String, String) CreateDefaultAttribute(String, String, String) CreateDefaultAttribute(String, String, String) CreateDefaultAttribute(String, String, String)

Creates a default attribute with the specified prefix, local name and namespace URI.

(Inherited from XmlDocument)
CreateDocumentFragment() CreateDocumentFragment() CreateDocumentFragment() CreateDocumentFragment()

Creates an XmlDocumentFragment.

(Inherited from XmlDocument)
CreateDocumentType(String, String, String, String) CreateDocumentType(String, String, String, String) CreateDocumentType(String, String, String, String) CreateDocumentType(String, String, String, String)

Returns a new XmlDocumentType object.

(Inherited from XmlDocument)
CreateElement(String) CreateElement(String) CreateElement(String) CreateElement(String)

Creates an element with the specified name.

(Inherited from XmlDocument)
CreateElement(String, String) CreateElement(String, String) CreateElement(String, String) CreateElement(String, String)

Creates an XmlElement with the qualified name and NamespaceURI.

(Inherited from XmlDocument)
CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String) CreateElement(String, String, String)

Creates an element with the specified Prefix, LocalName , and NamespaceURI.

CreateEntityReference(String) CreateEntityReference(String) CreateEntityReference(String) CreateEntityReference(String)

Creates an XmlEntityReference with the specified name.

CreateNavigator() CreateNavigator() CreateNavigator() CreateNavigator()

Creates a new XPathNavigator object for navigating this document.

(Inherited from XmlDocument)
CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode)

Creates a new XPathNavigator object for navigating this document. The XPathNavigator is positioned on the node specified in the node parameter.

CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String) CreateNode(String, String, String)

Creates an XmlNode with the specified node type, Name, and NamespaceURI.

(Inherited from XmlDocument)
CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String) CreateNode(XmlNodeType, String, String)

Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI.

(Inherited from XmlDocument)
CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String) CreateNode(XmlNodeType, String, String, String)

Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI.

(Inherited from XmlDocument)
CreateProcessingInstruction(String, String) CreateProcessingInstruction(String, String) CreateProcessingInstruction(String, String) CreateProcessingInstruction(String, String)

Creates an XmlProcessingInstruction with the specified name and data.

(Inherited from XmlDocument)
CreateSignificantWhitespace(String) CreateSignificantWhitespace(String) CreateSignificantWhitespace(String) CreateSignificantWhitespace(String)

Creates an XmlSignificantWhitespace node.

(Inherited from XmlDocument)
CreateTextNode(String) CreateTextNode(String) CreateTextNode(String) CreateTextNode(String)

Creates an XmlText with the specified text.

(Inherited from XmlDocument)
CreateWhitespace(String) CreateWhitespace(String) CreateWhitespace(String) CreateWhitespace(String)

Creates an XmlWhitespace node.

(Inherited from XmlDocument)
CreateXmlDeclaration(String, String, String) CreateXmlDeclaration(String, String, String) CreateXmlDeclaration(String, String, String) CreateXmlDeclaration(String, String, String)

Creates an XmlDeclaration node with the specified values.

(Inherited from XmlDocument)
Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetElementById(String) GetElementById(String) GetElementById(String) GetElementById(String)

Gets the XmlElement with the specified ID. This method is not supported by the XmlDataDocument class. Calling this method throws an exception.

GetElementFromRow(DataRow) GetElementFromRow(DataRow) GetElementFromRow(DataRow) GetElementFromRow(DataRow)

Retrieves the XmlElement associated with the specified DataRow.

GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String) GetElementsByTagName(String)

Returns an XmlNodeList containing a list of all descendant elements that match the specified Name.

GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String) GetElementsByTagName(String, String)

Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI.

(Inherited from XmlDocument)
GetEnumerator() GetEnumerator() GetEnumerator() GetEnumerator()

Get an enumerator that iterates through the child nodes in the current node.

(Inherited from XmlNode)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Serves as the default hash function.

(Inherited from Object)
GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String) GetNamespaceOfPrefix(String)

Looks up the closest xmlns declaration for the given prefix that is in scope for the current node and returns the namespace URI in the declaration.

(Inherited from XmlNode)
GetPrefixOfNamespace(String) GetPrefixOfNamespace(String) GetPrefixOfNamespace(String) GetPrefixOfNamespace(String)

Looks up the closest xmlns declaration for the given namespace URI that is in scope for the current node and returns the prefix defined in that declaration.

(Inherited from XmlNode)
GetRowFromElement(XmlElement) GetRowFromElement(XmlElement) GetRowFromElement(XmlElement) GetRowFromElement(XmlElement)

Retrieves the DataRow associated with the specified XmlElement.

GetType() GetType() GetType() GetType()

Gets the Type of the current instance.

(Inherited from Object)
ImportNode(XmlNode, Boolean) ImportNode(XmlNode, Boolean) ImportNode(XmlNode, Boolean) ImportNode(XmlNode, Boolean)

Imports a node from another document to the current document.

(Inherited from XmlDocument)
InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode) InsertAfter(XmlNode, XmlNode)

Inserts the specified node immediately after the specified reference node.

(Inherited from XmlNode)
InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode) InsertBefore(XmlNode, XmlNode)

Inserts the specified node immediately before the specified reference node.

(Inherited from XmlNode)
Load(Stream) Load(Stream) Load(Stream) Load(Stream)

Loads the XmlDataDocument from the specified stream.

Load(String) Load(String) Load(String) Load(String)

Loads the XmlDataDocument using the specified URL.

Load(TextReader) Load(TextReader) Load(TextReader) Load(TextReader)

Loads the XmlDataDocument from the specified TextReader.

Load(XmlReader) Load(XmlReader) Load(XmlReader) Load(XmlReader)

Loads the XmlDataDocument from the specified XmlReader.

LoadXml(String) LoadXml(String) LoadXml(String) LoadXml(String)

Loads the XML document from the specified string.

(Inherited from XmlDocument)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Creates a shallow copy of the current Object.

(Inherited from Object)
Normalize() Normalize() Normalize() Normalize()

Puts all XmlText nodes in the full depth of the sub-tree underneath this XmlNode into a "normal" form where only markup (that is, tags, comments, processing instructions, CDATA sections, and entity references) separates XmlText nodes, that is, there are no adjacent XmlText nodes.

(Inherited from XmlNode)
PrependChild(XmlNode) PrependChild(XmlNode) PrependChild(XmlNode) PrependChild(XmlNode)

Adds the specified node to the beginning of the list of child nodes for this node.

(Inherited from XmlNode)
ReadNode(XmlReader) ReadNode(XmlReader) ReadNode(XmlReader) ReadNode(XmlReader)

Creates an XmlNode object based on the information in the XmlReader. The reader must be positioned on a node or attribute.

(Inherited from XmlDocument)
RemoveAll() RemoveAll() RemoveAll() RemoveAll()

Removes all the child nodes and/or attributes of the current node.

(Inherited from XmlNode)
RemoveChild(XmlNode) RemoveChild(XmlNode) RemoveChild(XmlNode) RemoveChild(XmlNode)

Removes specified child node.

(Inherited from XmlNode)
ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode) ReplaceChild(XmlNode, XmlNode)

Replaces the child node oldChild with newChild node.

(Inherited from XmlNode)
Save(Stream) Save(Stream) Save(Stream) Save(Stream)

Saves the XML document to the specified stream.

(Inherited from XmlDocument)
Save(String) Save(String) Save(String) Save(String)

Saves the XML document to the specified file. If the specified file exists, this method overwrites it.

(Inherited from XmlDocument)
Save(TextWriter) Save(TextWriter) Save(TextWriter) Save(TextWriter)

Saves the XML document to the specified TextWriter.

(Inherited from XmlDocument)
Save(XmlWriter) Save(XmlWriter) Save(XmlWriter) Save(XmlWriter)

Saves the XML document to the specified XmlWriter.

(Inherited from XmlDocument)
SelectNodes(String) SelectNodes(String) SelectNodes(String) SelectNodes(String)

Selects a list of nodes matching the XPath expression.

(Inherited from XmlNode)
SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager) SelectNodes(String, XmlNamespaceManager)

Selects a list of nodes matching the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

(Inherited from XmlNode)
SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String) SelectSingleNode(String)

Selects the first XmlNode that matches the XPath expression.

(Inherited from XmlNode)
SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager) SelectSingleNode(String, XmlNamespaceManager)

Selects the first XmlNode that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.

(Inherited from XmlNode)
Supports(String, String) Supports(String, String) Supports(String, String) Supports(String, String)

Tests if the DOM implementation implements a specific feature.

(Inherited from XmlNode)
ToString() ToString() ToString() ToString()

Returns a string that represents the current object.

(Inherited from Object)
Validate(ValidationEventHandler) Validate(ValidationEventHandler) Validate(ValidationEventHandler) Validate(ValidationEventHandler)

Validates the XmlDocument against the XML Schema Definition Language (XSD) schemas contained in the Schemas property.

(Inherited from XmlDocument)
Validate(ValidationEventHandler, XmlNode) Validate(ValidationEventHandler, XmlNode) Validate(ValidationEventHandler, XmlNode) Validate(ValidationEventHandler, XmlNode)

Validates the XmlNode object specified against the XML Schema Definition Language (XSD) schemas in the Schemas property.

(Inherited from XmlDocument)
WriteContentTo(XmlWriter) WriteContentTo(XmlWriter) WriteContentTo(XmlWriter) WriteContentTo(XmlWriter)

Saves all the children of the XmlDocument node to the specified XmlWriter.

(Inherited from XmlDocument)
WriteTo(XmlWriter) WriteTo(XmlWriter) WriteTo(XmlWriter) WriteTo(XmlWriter)

Saves the XmlDocument node to the specified XmlWriter.

(Inherited from XmlDocument)

Events

NodeChanged NodeChanged NodeChanged NodeChanged

Occurs when the Value of a node belonging to this document has been changed.

(Inherited from XmlDocument)
NodeChanging NodeChanging NodeChanging NodeChanging

Occurs when the Value of a node belonging to this document is about to be changed.

(Inherited from XmlDocument)
NodeInserted NodeInserted NodeInserted NodeInserted

Occurs when a node belonging to this document has been inserted into another node.

(Inherited from XmlDocument)
NodeInserting NodeInserting NodeInserting NodeInserting

Occurs when a node belonging to this document is about to be inserted into another node.

(Inherited from XmlDocument)
NodeRemoved NodeRemoved NodeRemoved NodeRemoved

Occurs when a node belonging to this document has been removed from its parent.

(Inherited from XmlDocument)
NodeRemoving NodeRemoving NodeRemoving NodeRemoving

Occurs when a node belonging to this document is about to be removed from the document.

(Inherited from XmlDocument)

Explicit Interface Implementations

ICloneable.Clone() ICloneable.Clone() ICloneable.Clone() ICloneable.Clone()

For a description of this member, see Clone().

(Inherited from XmlNode)
IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator() IEnumerable.GetEnumerator()

For a description of this member, see GetEnumerator().

(Inherited from XmlNode)

Extension Methods

Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable) Cast<TResult>(IEnumerable)

Casts the elements of an IEnumerable to the specified type.

OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable) OfType<TResult>(IEnumerable)

Filters the elements of an IEnumerable based on a specified type.

AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable) AsParallel(IEnumerable)

Enables parallelization of a query.

AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable) AsQueryable(IEnumerable)

Converts an IEnumerable to an IQueryable.

CreateNavigator(XmlDocument) CreateNavigator(XmlDocument) CreateNavigator(XmlDocument) CreateNavigator(XmlDocument)
CreateNavigator(XmlDocument, XmlNode) CreateNavigator(XmlDocument, XmlNode) CreateNavigator(XmlDocument, XmlNode) CreateNavigator(XmlDocument, XmlNode)
CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode) CreateNavigator(XmlNode)
SelectNodes(XmlNode, String) SelectNodes(XmlNode, String) SelectNodes(XmlNode, String) SelectNodes(XmlNode, String)
SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager) SelectNodes(XmlNode, String, XmlNamespaceManager)
SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String) SelectSingleNode(XmlNode, String)
SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager) SelectSingleNode(XmlNode, String, XmlNamespaceManager)
ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode) ToXPathNavigable(XmlNode)

Applies to