XmlDocument Class
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Represents an XML document. You can use this class to load, validate, edit, add, and position XML in a document.
public ref class XmlDocument : System::Xml::XmlNode
public class XmlDocument : System.Xml.XmlNode
type XmlDocument = class
inherit XmlNode
Public Class XmlDocument
Inherits XmlNode
- Inheritance
- Derived
Remarks
For more information about this API, see Supplemental API remarks for XmlDocument.
Constructors
XmlDocument() |
Initializes a new instance of the XmlDocument class. |
XmlDocument(XmlImplementation) |
Initializes a new instance of the |
XmlDocument(XmlNameTable) |
Initializes a new instance of the |
Properties
Attributes |
Gets an XmlAttributeCollection containing the attributes of this node. (Inherited from XmlNode) |
BaseURI |
Gets the base URI of the current node. |
ChildNodes |
Gets all the child nodes of the node. (Inherited from XmlNode) |
DocumentElement |
Gets the root XmlElement for the document. |
DocumentType |
Gets the node containing the DOCTYPE declaration. |
FirstChild |
Gets the first child of the node. (Inherited from XmlNode) |
HasChildNodes |
Gets a value indicating whether this node has any child nodes. (Inherited from XmlNode) |
Implementation |
Gets the XmlImplementation object for the current document. |
InnerText |
Throws an InvalidOperationException in all cases. |
InnerText |
Gets or sets the concatenated values of the node and all its child nodes. (Inherited from XmlNode) |
InnerXml |
Gets or sets the markup representing the children of the current node. |
IsReadOnly |
Gets a value indicating whether the current node is read-only. |
Item[String, String] |
Gets the first child element with the specified LocalName and NamespaceURI. (Inherited from XmlNode) |
Item[String] |
Gets the first child element with the specified Name. (Inherited from XmlNode) |
LastChild |
Gets the last child of the node. (Inherited from XmlNode) |
LocalName |
Gets the local name of the node. |
Name |
Gets the qualified name of the node. |
NamespaceURI |
Gets the namespace URI of this node. (Inherited from XmlNode) |
NameTable |
Gets the XmlNameTable associated with this implementation. |
NextSibling |
Gets the node immediately following this node. (Inherited from XmlNode) |
NodeType |
Gets the type of the current node. |
OuterXml |
Gets the markup containing this node and all its child nodes. (Inherited from XmlNode) |
OwnerDocument |
Gets the XmlDocument to which the current node belongs. |
ParentNode |
Gets the parent node of this node (for nodes that can have parents). |
ParentNode |
Gets the parent of this node (for nodes that can have parents). (Inherited from XmlNode) |
Prefix |
Gets or sets the namespace prefix of this node. (Inherited from XmlNode) |
PreserveWhitespace |
Gets or sets a value indicating whether to preserve white space in element content. |
PreviousSibling |
Gets the node immediately preceding this node. (Inherited from XmlNode) |
PreviousText |
Gets the text node that immediately precedes this node. (Inherited from XmlNode) |
SchemaInfo |
Returns the Post-Schema-Validation-Infoset (PSVI) of the node. |
SchemaInfo |
Gets the post schema validation infoset that has been assigned to this node as a result of schema validation. (Inherited from XmlNode) |
Schemas |
Gets or sets the XmlSchemaSet object associated with this XmlDocument. |
Value |
Gets or sets the value of the node. (Inherited from XmlNode) |
XmlResolver |
Sets the XmlResolver to use for resolving external resources. |
Methods
AppendChild(XmlNode) |
Adds the specified node to the end of the list of child nodes, of this node. (Inherited from XmlNode) |
Clone() |
Creates a duplicate of this node. (Inherited from XmlNode) |
CloneNode(Boolean) |
Creates a duplicate of this node. |
CreateAttribute(String) |
Creates an XmlAttribute with the specified Name. |
CreateAttribute(String, String) |
Creates an XmlAttribute with the specified qualified name and NamespaceURI. |
CreateAttribute(String, String, String) |
Creates an XmlAttribute with the specified Prefix, LocalName, and NamespaceURI. |
CreateCDataSection(String) |
Creates an XmlCDataSection containing the specified data. |
CreateComment(String) |
Creates an XmlComment containing the specified data. |
CreateDefaultAttribute(String, String, String) |
Creates a default attribute with the specified prefix, local name and namespace URI. |
CreateDocumentFragment() |
Creates an XmlDocumentFragment. |
CreateDocumentType(String, String, String, String) |
Returns a new XmlDocumentType object. |
CreateElement(String) |
Creates an element with the specified name. |
CreateElement(String, String) |
Creates an XmlElement with the qualified name and NamespaceURI. |
CreateElement(String, String, String) |
Creates an element with the specified Prefix, LocalName, and NamespaceURI. |
CreateEntityReference(String) |
Creates an XmlEntityReference with the specified name. |
CreateNavigator() |
Creates a new XPathNavigator object for navigating this document. |
CreateNavigator() |
Creates an XPathNavigator for navigating this object. (Inherited from XmlNode) |
CreateNavigator(XmlNode) |
Creates an XPathNavigator object for navigating this document positioned on the XmlNode specified. |
CreateNode(String, String, String) |
Creates an XmlNode with the specified node type, Name, and NamespaceURI. |
CreateNode(XmlNodeType, String, String) |
Creates an XmlNode with the specified XmlNodeType, Name, and NamespaceURI. |
CreateNode(XmlNodeType, String, String, String) |
Creates a XmlNode with the specified XmlNodeType, Prefix, Name, and NamespaceURI. |
CreateProcessingInstruction(String, String) |
Creates an XmlProcessingInstruction with the specified name and data. |
CreateSignificantWhitespace(String) |
Creates an XmlSignificantWhitespace node. |
CreateTextNode(String) |
Creates an XmlText with the specified text. |
CreateWhitespace(String) |
Creates an XmlWhitespace node. |
CreateXmlDeclaration(String, String, String) |
Creates an XmlDeclaration node with the specified values. |
Equals(Object) |
Determines whether the specified object is equal to the current object. (Inherited from Object) |
GetElementById(String) |
Gets the XmlElement with the specified ID. |
GetElementsByTagName(String) |
Returns an XmlNodeList containing a list of all descendant elements that match the specified Name. |
GetElementsByTagName(String, String) |
Returns an XmlNodeList containing a list of all descendant elements that match the specified LocalName and NamespaceURI. |
GetEnumerator() |
Gets an enumerator that iterates through the child nodes in the current node. (Inherited from XmlNode) |
GetHashCode() |
Serves as the default hash function. (Inherited from Object) |
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) |
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) |
GetType() |
Gets the Type of the current instance. (Inherited from Object) |
ImportNode(XmlNode, Boolean) |
Imports a node from another document to the current document. |
InsertAfter(XmlNode, XmlNode) |
Inserts the specified node immediately after the specified reference node. (Inherited from XmlNode) |
InsertBefore(XmlNode, XmlNode) |
Inserts the specified node immediately before the specified reference node. (Inherited from XmlNode) |
Load(Stream) |
Loads the XML document from the specified stream. |
Load(String) |
Loads the XML document from the specified URL. |
Load(TextReader) |
Loads the XML document from the specified TextReader. |
Load(XmlReader) |
Loads the XML document from the specified XmlReader. |
LoadXml(String) |
Loads the XML document from the specified string. |
MemberwiseClone() |
Creates a shallow copy of the current Object. (Inherited from Object) |
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) |
Adds the specified node to the beginning of the list of child nodes for this node. (Inherited from XmlNode) |
ReadNode(XmlReader) |
Creates an XmlNode object based on the information in the XmlReader. The reader must be positioned on a node or attribute. |
RemoveAll() |
Removes all the child nodes and/or attributes of the current node. (Inherited from XmlNode) |
RemoveChild(XmlNode) |
Removes specified child node. (Inherited from XmlNode) |
ReplaceChild(XmlNode, XmlNode) |
Replaces the child node |
Save(Stream) |
Saves the XML document to the specified stream. |
Save(String) |
Saves the XML document to the specified file. If the specified file exists, this method overwrites it. |
Save(TextWriter) |
Saves the XML document to the specified TextWriter. |
Save(XmlWriter) |
Saves the XML document to the specified XmlWriter. |
SelectNodes(String) |
Selects a list of nodes matching the XPath expression. (Inherited from XmlNode) |
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) |
Selects the first |
SelectSingleNode(String, XmlNamespaceManager) |
Selects the first |
Supports(String, String) |
Tests if the DOM implementation implements a specific feature. (Inherited from XmlNode) |
ToString() |
Returns a string that represents the current object. (Inherited from Object) |
Validate(ValidationEventHandler) |
Validates the XmlDocument against the XML Schema Definition Language (XSD) schemas contained in the Schemas property. |
Validate(ValidationEventHandler, XmlNode) |
Validates the XmlNode object specified against the XML Schema Definition Language (XSD) schemas in the Schemas property. |
WriteContentTo(XmlWriter) |
Saves all the children of the |
WriteTo(XmlWriter) |
Saves the |
Events
NodeChanged |
Occurs when the Value of a node belonging to this document has been changed. |
NodeChanging |
Occurs when the Value of a node belonging to this document is about to be changed. |
NodeInserted |
Occurs when a node belonging to this document has been inserted into another node. |
NodeInserting |
Occurs when a node belonging to this document is about to be inserted into another node. |
NodeRemoved |
Occurs when a node belonging to this document has been removed from its parent. |
NodeRemoving |
Occurs when a node belonging to this document is about to be removed from the document. |
Explicit Interface Implementations
ICloneable.Clone() |
For a description of this member, see Clone(). (Inherited from XmlNode) |
IEnumerable.GetEnumerator() |
For a description of this member, see GetEnumerator(). (Inherited from XmlNode) |
Extension Methods
Cast<TResult>(IEnumerable) |
Casts the elements of an IEnumerable to the specified type. |
OfType<TResult>(IEnumerable) |
Filters the elements of an IEnumerable based on a specified type. |
AsParallel(IEnumerable) |
Enables parallelization of a query. |
AsQueryable(IEnumerable) |
Converts an IEnumerable to an IQueryable. |
CreateNavigator(XmlDocument) |
Creates a new XPath navigator object for navigating the specified document. |
CreateNavigator(XmlDocument, XmlNode) |
Creates an XPath navigator object for navigating the specified document positioned on the specified node. |
CreateNavigator(XmlNode) |
Creates an XPath navigator for navigating the specified node. |
SelectNodes(XmlNode, String) |
Selects a list of nodes matching the specified XPath expression. |
SelectNodes(XmlNode, String, XmlNamespaceManager) |
Selects a list of nodes matching the specified XPath expression. Any prefixes found in the XPath expression are resolved using the supplied namespace manager. |
SelectSingleNode(XmlNode, String) |
Selects the first node that matches the XPath expression. |
SelectSingleNode(XmlNode, String, XmlNamespaceManager) |
Selects the first node that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied namespace manager. |
ToXPathNavigable(XmlNode) |
Creates an IXPathNavigable instance used for producing navigators. |
Applies to
See also
Feedback
https://aka.ms/ContentUserFeedback.
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see:Submit and view feedback for