System.Xml.XmlEntityReference Class

Summary

Represents an entity reference node.

C# Syntax:

public class XmlEntityReference : XmlLinkedNode

System.Xml Namespace

System.Xml.XmlEntityReference Member List:

Public Properties

Attributes (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.Attributes Gets an XmlAttributeCollection containing the attributes of this node.
BaseURI	Read-only Overridden: Gets the base URI of the current node.
ChildNodes (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.ChildNodes Gets all the children of the node.
FirstChild (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.FirstChild Gets the first child of the node.
HasChildNodes (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.HasChildNodes Gets a value indicating whether this node has any child nodes.
InnerText (inherited from System.Xml.XmlNode)	Read-write See base class member description: System.Xml.XmlNode.InnerText Gets or sets the concatenated values of the node and all its children.
InnerXml (inherited from System.Xml.XmlNode)	Read-write See base class member description: System.Xml.XmlNode.InnerXml Gets or sets the markup representing just the children of this node.
IsReadOnly	Read-only Overridden: Gets a value indicating whether the node is read-only.
Item (inherited from System.Xml.XmlNode)	Read-only Overloaded: Item[string name] {get See base class member description: System.Xml.XmlNode.Item Gets the first child element with the specified XmlNode.Name.
Item (inherited from System.Xml.XmlNode)	Read-only Overloaded: Item[string localname, string ns] {get See base class member description: System.Xml.XmlNode.Item Gets the first child element with the specified XmlNode.LocalName and XmlNode.NamespaceURI.
LastChild (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.LastChild Gets the last child of the node.
LocalName	Read-only Overridden: Gets the local name of the node.
Name	Read-only Overridden: Gets the name of the node.
NamespaceURI (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.NamespaceURI Gets the namespace URI of this node.
NextSibling (inherited from System.Xml.XmlLinkedNode)	Read-only See base class member description: System.Xml.XmlLinkedNode.NextSibling Gets the node immediately following this node.
NodeType	Read-only Overridden: Gets the type of the node.
OuterXml (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.OuterXml Gets the markup representing this node and all its children.
OwnerDocument (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.OwnerDocument Gets the XmlDocument to which this node belongs.
ParentNode (inherited from System.Xml.XmlNode)	Read-only See base class member description: System.Xml.XmlNode.ParentNode Gets the parent of this node (for nodes that can have parents).
Prefix (inherited from System.Xml.XmlNode)	Read-write See base class member description: System.Xml.XmlNode.Prefix Gets or sets the namespace prefix of this node.
PreviousSibling (inherited from System.Xml.XmlLinkedNode)	Read-only See base class member description: System.Xml.XmlLinkedNode.PreviousSibling Gets the node immediately preceding this node.
Value	Read-write Overridden: Gets or sets the value of the node.

Public Methods

AppendChild (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.AppendChild Adds the specified node to the end of the list of children of this node.
Clone (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.Clone Creates a duplicate of this node.
CloneNode	Overridden: Creates a duplicate of this node.
CreateNavigator (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.CreateNavigator Creates an XPathNavigator for navigating this object.
Equals (inherited from System.Object)	See base class member description: System.Object.Equals Derived from System.Object, the primary base class for all objects.
GetEnumerator (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.GetEnumerator Provides support for the for each style iteration over the nodes in the XmlNode.
GetHashCode (inherited from System.Object)	See base class member description: System.Object.GetHashCode Derived from System.Object, the primary base class for all objects.
GetNamespaceOfPrefix (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.GetNamespaceOfPrefix 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.
GetPrefixOfNamespace (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.GetPrefixOfNamespace 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.
GetType (inherited from System.Object)	See base class member description: System.Object.GetType Derived from System.Object, the primary base class for all objects.
InsertAfter (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.InsertAfter Inserts the specified node immediately after the specified reference node.
InsertBefore (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.InsertBefore Inserts the specified node immediately before the specified reference node.
Normalize (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.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.
PrependChild (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.PrependChild Adds the specified node to the beginning of the list of children of this node.
RemoveAll (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.RemoveAll Removes all the children and/or attributes of the current node.
RemoveChild (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.RemoveChild Removes specified child node.
ReplaceChild (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.ReplaceChild Replaces the child node oldChild with newChild node.
SelectNodes (inherited from System.Xml.XmlNode)	Overloaded: SelectNodes(string xpath) See base class member description: System.Xml.XmlNode.SelectNodes Selects a list of nodes matching the XPath expression.
SelectNodes (inherited from System.Xml.XmlNode)	Overloaded: SelectNodes(string xpath, XmlNamespaceManager nsmgr) See base class member description: System.Xml.XmlNode.SelectNodes Selects a list of nodes matching the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.
SelectSingleNode (inherited from System.Xml.XmlNode)	Overloaded: SelectSingleNode(string xpath) See base class member description: System.Xml.XmlNode.SelectSingleNode Selects the first XmlNode that matches the XPath expression.
SelectSingleNode (inherited from System.Xml.XmlNode)	Overloaded: SelectSingleNode(string xpath, XmlNamespaceManager nsmgr) See base class member description: System.Xml.XmlNode.SelectSingleNode Selects the first XmlNode that matches the XPath expression. Any prefixes found in the XPath expression are resolved using the supplied XmlNamespaceManager.
Supports (inherited from System.Xml.XmlNode)	See base class member description: System.Xml.XmlNode.Supports Test if the DOM implementation implements a specific feature.
ToString (inherited from System.Object)	See base class member description: System.Object.ToString Derived from System.Object, the primary base class for all objects.
WriteContentTo	Overridden: Saves all the children of the node to the specified XmlWriter.
WriteTo	Overridden: Saves the node to the specified XmlWriter.

Protected Constructors

ctor #1

Protected Methods

Finalize (inherited from System.Object)	See base class member description: System.Object.Finalize Derived from System.Object, the primary base class for all objects.
MemberwiseClone (inherited from System.Object)	See base class member description: System.Object.MemberwiseClone Derived from System.Object, the primary base class for all objects.

Hierarchy:

• System.Object
• System.Xml.XmlNode
• System.Xml.XmlLinkedNode
• System.Xml.XmlEntityReference

System.Xml.XmlEntityReference Member Details

Summary

This type supports the Shared Source CLI infrastructure and is not intended to be used directly from your code.

C# Syntax:

protected internal XmlEntityReference(    string name,    XmlDocument doc );

name

doc

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Attributes

Summary

Gets an XmlAttributeCollection containing the attributes of this node.

C# Syntax:

public virtual XmlAttributeCollection Attributes {get;}

The following example adds a new attribute to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Create a new attribute.
    string ns = root.GetNamespaceOfPrefix("bk");
    XmlNode attr = doc.CreateNode(XmlNodeType.Attribute, "genre", ns);
    attr.Value = "novel";

    //Add the attribute to the document.
    root.Attributes.SetNamedItem(attr);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Summary

Gets the base URI of the current node.

C# Syntax:

public override string BaseURI {get;}

A networked XML document is comprised of chunks of data aggregated using various W3C standard inclusion mechanisms and therefore contains nodes that come from different places. The BaseURI tells you where these nodes came from. If there is no base URI for the nodes being returned (maybe they were parsed from an in-memory string), String.Empty is returned.

BaseURI walks the node tree looking for entity reference boundaries, so if entities are expanded this information is not preserved and this property returns the location of the XmlDocument in all cases.

For additional information on BaseURI and how it behaves with other node types, see XmlNode.BaseURI.

This property is a Microsoft extension to the Document Object Model (DOM).

The following example displays information on entity reference node, including its base URI.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.Load("http://localhost/uri.xml");
                     
    //Display information on the entity reference node.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    Console.WriteLine("Name of the entity reference:  {0}", entref.Name);
    Console.WriteLine("Base URI of the entity reference:  {0}", entref.BaseURI);
    Console.WriteLine("The entity replacement text:  {0}", entref.InnerText);
  }
}

    

The sample uses the file, uri.xml, as input.

The

<!-- XML fragment -->
<!DOCTYPE book [<!ENTITY s SYSTEM "tmp/style.xml">]>
<book genre="novel">
  <title>Pride and Prejudice</title>
  <misc>&s;</misc>
</book>

    

style.xml file contains the XML string <style>hardcover</style> .

Return to top

Inherited
See base class member description: System.Xml.XmlNode.ChildNodes

Summary

Gets all the children of the node.

C# Syntax:

public virtual XmlNodeList ChildNodes {get;}

The following example displays all the child nodes of the root element.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Display the contents of the child nodes.
    if (root.HasChildNodes)
    {
      for (int i=0; i<root.ChildNodes.Count; i++)
      {
        Console.WriteLine(root.ChildNodes[i].InnerText);
      }
    }
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.FirstChild

Summary

Gets the first child of the node.

C# Syntax:

public virtual XmlNode FirstChild {get;}

The following example displays the title element.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    Console.WriteLine("Display the title element...");
    Console.WriteLine(root.FirstChild.OuterXml);
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.HasChildNodes

Summary

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

C# Syntax:

public virtual bool HasChildNodes {get;}

The following example displays all the child nodes of the root element.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Display the contents of the child nodes.
    if (root.HasChildNodes)
    {
      for (int i=0; i<root.ChildNodes.Count; i++)
      {
        Console.WriteLine(root.ChildNodes[i].InnerText);
      }
    }
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.InnerText

Summary

Gets or sets the concatenated values of the node and all its children.

C# Syntax:

public virtual string InnerText {get; set;}

Setting this property replaces all the children with the parsed contents of the given string.

For leaf nodes, InnerText returns the same content as the XmlNode.Value property.

This property is a Microsoft extension to the Document Object Model (DOM).

The following example compares the InnerText and XmlNode.InnerXml properties.

using System;
using System.Xml;
public class Test {

  public static void Main() {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<root>"+
                "<elem>some text<child/>more text</elem>" +
                "</root>");

    XmlNode elem = doc.DocumentElement.FirstChild;

    //Note that InnerText does not include the markup.
    Console.WriteLine("Display the InnerText of the element...");
    Console.WriteLine( elem.InnerText );

    //InnerXml includes the element's markup.
    Console.WriteLine("Display the InnerXml of the element...");
    Console.WriteLine(elem.InnerXml);

    //Set InnerText to a string that includes markup.  
    //The markup is entitized.
    elem.InnerText = "Text containing <markup/> will have char(<) and char(>) entitized.";
    Console.WriteLine( elem.OuterXml );

    //Set InnerXml to a string that includes markup.  
    //The markup is not entitized.
    elem.InnerXml = "Text containing <markup/>.";
    Console.WriteLine( elem.OuterXml );
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.InnerXml

Summary

Gets or sets the markup representing just the children of this node.

C# Syntax:

public virtual string InnerXml {get; set;}

Attempting to set this property from a node that cannot have children, for example a Text node, throws an exception. Otherwise, setting InnerXml replaces the children of the node with the parsed contents of the given string. The parsing is done in the current namespace context.

This property is a Microsoft extension to the Document Object Model (DOM).

The following example compares the XmlNode.InnerText and InnerXml properties.

using System;
using System.Xml;
public class Test {

  public static void Main() {
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<root>"+
                "<elem>some text<child/>more text</elem>" +
                "</root>");

    XmlNode elem = doc.DocumentElement.FirstChild;

    //Note that InnerText does not include the markup.
    Console.WriteLine("Display the InnerText of the element...");
    Console.WriteLine( elem.InnerText );

    //InnerXml includes the element's markup.
    Console.WriteLine("Display the InnerXml of the element...");
    Console.WriteLine(elem.InnerXml);

    //Set InnerText to a string that includes markup.  
    //The markup is entitized.
    elem.InnerText = "Text containing <markup/> will have char(<) and char(>) entitized.";
    Console.WriteLine( elem.OuterXml );

    //Set InnerXml to a string that includes markup.  
    //The markup is not entitized.
    elem.InnerXml = "Text containing <markup/>.";
    Console.WriteLine( elem.OuterXml );
  }
}

    

Return to top

Summary

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

C# Syntax:

public override bool IsReadOnly {get;}

A read-only node is one whose properties, attributes, or children cannot be changed. However, you can remove a read-only node from the tree and insert it somewhere else.

This property is a Microsoft extension to the Document Object Model (DOM).

The following example shows how to use the IsReadOnly property.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<!DOCTYPE book [<!ENTITY h 'hardcover'>]>" +
                "<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<style>&h;</style>" +
                "</book>");

    //Check if the node is read-only.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    if (entref.IsReadOnly)
       Console.WriteLine("Entity reference nodes are always read-only");
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Item

Summary

Gets the first child element with the specified XmlNode.Name.

C# Syntax:

public virtual XmlElement this[string name] {get;}

name

The qualified name of the element to retrieve

This property is a Microsoft extension to the Document Object Model (DOM).

The following example displays the title element.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    Console.WriteLine("Display the title element...");
    Console.WriteLine(root["title"].OuterXml);
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Item

Summary

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

C# Syntax:

public virtual XmlElement this[string localname, string ns] {get;}

localname

The local name of the element.

ns

The namespace URI of the element.

This property is a Microsoft extension to the Document Object Model (DOM).

Return to top

Inherited
See base class member description: System.Xml.XmlNode.LastChild

Summary

Gets the last child of the node.

C# Syntax:

public virtual XmlNode LastChild {get;}

The following example displays the price element.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    Console.WriteLine("Display the price element...");
    Console.WriteLine(root.LastChild.OuterXml);
  }
}

    

Return to top

Summary

Gets the local name of the node.

C# Syntax:

public override string LocalName {get;}

Return to top

Summary

Gets the name of the node.

C# Syntax:

public override string Name {get;}

The following example displays information on the entity reference node.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    //Create the XmlDocument.
    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<!DOCTYPE book [<!ENTITY h 'hardcover'>]>" +
                "<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<style>&h;</style>" +
                "</book>");

    //Display information on the entity reference node.
    XmlEntityReference entref = (XmlEntityReference) doc.DocumentElement.LastChild.FirstChild;
    Console.WriteLine("Name of the entity reference:  {0}", entref.Name);
    Console.WriteLine("The entity replacement text:  {0}", entref.InnerText);
  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.NamespaceURI

Summary

Gets the namespace URI of this node.

C# Syntax:

public virtual string NamespaceURI {get;}

This is the namespace URI specified at creation time. For example, NamespaceURI is urn:samples for the element <bk:book xmlns:bk= "urn:samples">

An attribute does not inherit its namespace from the element it is attached to. If an attribute is not explicitly given a namespace, it simply has no namespace.

Return to top

Inherited
See base class member description: System.Xml.XmlLinkedNode.NextSibling

Summary

Gets the node immediately following this node.

C# Syntax:

public override XmlNode NextSibling {get;}

The following example displays the first two book nodes.

 using System;
 using System.IO;
 using System.Xml;
 
 public class Sample
 {
   public static void Main()
   {

      XmlDocument doc = new XmlDocument();
      doc.Load("books.xml");
 
      // Display the first two book nodes.
      XmlNode book = doc.DocumentElement.FirstChild;
      Console.WriteLine(book.OuterXml);
      Console.WriteLine();
      Console.WriteLine(book.NextSibling.OuterXml);
 
   }
 }

    

Return to top

Summary

Gets the type of the node.

C# Syntax:

public override XmlNodeType NodeType {get;}

Return to top

Inherited
See base class member description: System.Xml.XmlNode.OuterXml

Summary

Gets the markup representing this node and all its children.

C# Syntax:

public virtual string OuterXml {get;}

This property is a Microsoft extension to the Document Object Model (DOM).

The following example compares output from the XmlNode.InnerXml and OuterXml properties.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //OuterXml includes the markup of current node.
    Console.WriteLine("Display the OuterXml property...");
    Console.WriteLine(root.OuterXml);
            
    //InnerXml does not include the markup of the current node.
    //As a result, the attributes are not displayed.
    Console.WriteLine();
    Console.WriteLine("Display the InnerXml property...");
    Console.WriteLine(root.InnerXml);
           
    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.OwnerDocument

Summary

Gets the XmlDocument to which this node belongs.

C# Syntax:

public virtual XmlDocument OwnerDocument {get;}

When adding nodes to the current node, use the XmlDocument returned by the XmlNode.OwnerDocument property to create the node.

See XmlElement.OwnerDocument (in the XmlElement class) for an example using this property.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.ParentNode

Summary

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

C# Syntax:

public virtual XmlNode ParentNode {get;}

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Prefix

Summary

Gets or sets the namespace prefix of this node.

C# Syntax:

public virtual string Prefix {get; set;}

Exceptions

Exception Type	Condition
ArgumentException	This node is read-only
XmlException	The specified prefix contains an illegal character The specified prefix is malformed. The specified prefix is "xml" and the namespaceURI of this node is different from "http://www.w3.org/XML/1998/namespace". This node is an attribute and the specified prefix is "xmlns" and the namespaceURI of this node is different from "http://www.w3.org/2000/xmlns/." This node is an attribute and the qualifiedName of this node is "xmlns".

Setting this property, when permitted, changes the XmlNode.Name property, which holds the qualified name, on Element and Attribute nodes. Setting this property on node types that cannot have a prefix (such as Text, Comment, EntityReference, CDATA, ProcessingInstruction, Document, and DocumentFragment) has no effect. Changing the prefix of an attribute that is known to have a default value, does not make a new attribute with the default value and the original prefix appear, since the namespace URI and local name do not change.

Notes to inheritors: When overriding Prefix in a derived class, this property will not be settable.

Return to top

Inherited
See base class member description: System.Xml.XmlLinkedNode.PreviousSibling

Summary

Gets the node immediately preceding this node.

C# Syntax:

public override XmlNode PreviousSibling {get;}

Return to top

Summary

Gets or sets the value of the node.

C# Syntax:

public override string Value {get; set;}

Exceptions

Exception Type	Condition
ArgumentException	Node is read-only.
InvalidOperationException	Setting the property.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.AppendChild

Summary

Adds the specified node to the end of the list of children of this node.

C# Syntax:

public virtual XmlNode AppendChild(    XmlNode newChild );

newChild

The node to add. If it is a XmlDocumentFragment, the entire contents of the document fragment are moved into the child list of this node.

Return Value:

The node added.

Exceptions

Exception Type	Condition
InvalidOperationException	This node is of a type that does not allow children of the type of the newChild node. Or the node to be added is one of this node's ancestors.
ArgumentException	The newChild was created from a different document than the one that created this node. This node is read-only.

If the newChild is already in the tree, it is first removed.

Notes to inheritors: When overriding AppendChild in a derived class, in order for events to be fired correctly, you must call the base class's AppendChild method.

The following example adds a new node to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Clone

Summary

Creates a duplicate of this node.

C# Syntax:

public virtual XmlNode Clone();

Return Value:

The cloned node.

Cloning an XmlElement copies all attributes and their values, including those generated by the XML processor to represent defaulted attributes. This method recursively clones the node and the subtree underneath it.

Clone is equivalent to calling CloneNode(true) .

This method is a Microsoft extension to the Document Object Model (DOM).

The following example clones the root node of the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "<price>19.95</price>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Clone the root node.  The cloned node includes
    //child nodes. This is similar to calling CloneNode(true).
    XmlNode clone = root.Clone();
    Console.WriteLine(clone.OuterXml);
  }
}

    

Return to top

Summary

Creates a duplicate of this node.

C# Syntax:

public override XmlNode CloneNode(    bool deep );

deep

true to recursively clone the subtree under the specified node; false to clone only the node itself. For XmlEntityReference nodes, this method always returns an entity reference node with no children. The replacement text is set when the node is inserted into a parent.

Return Value:

The cloned node.

This method serves as a copy constructor for nodes. The cloned node has no parent ( XmlNode.ParentNode returns null).

Return to top

Inherited
See base class member description: System.Xml.XmlNode.CreateNavigator

Summary

Creates an XPathNavigator for navigating this object.

C# Syntax:

public XPathNavigator CreateNavigator();

Return Value:

An XPathNavigator object. The XPathNavigator is positioned on the node from which the method was called. It is not positioned on the root of the document.

Implements:

IXPathNavigable.CreateNavigator

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 XslTransform.Transform method.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example loads and edits an XML document before performing an XSLT transform.

  XmlDocument doc = new XmlDocument();
  doc.Load("books.xml");

  // Modify the XML file.
  XmlElement root = doc.DocumentElement;
  root.FirstChild.LastChild.InnerText = "12.95";

  // Create an XPathNavigator to use for the transform.
  XPathNavigator nav = root.CreateNavigator();
  
  // Transform the file.
  XslTransform xslt = new XslTransform();
  xslt.Load("output.xsl");
  XmlTextWriter writer = new XmlTextWriter("books.html", null);
  xslt.Transform(nav, null, writer);

    

Return to top

Inherited
See base class member description: System.Object.Equals

C# Syntax:

public virtual bool Equals(    object obj );

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Object.Finalize

C# Syntax:

~XmlEntityReference();

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.GetEnumerator

Summary

Provides support for the for each style iteration over the nodes in the XmlNode.

C# Syntax:

public IEnumerator GetEnumerator();

Return Value:

An IEnumerator.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example displays all the books in the XML document.

using System;
using System.Collections;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.Load("books.xml");

    Console.WriteLine("Display all the books...");
    XmlNode root = doc.DocumentElement;
    IEnumerator ienum = root.GetEnumerator();
    XmlNode book;
    while (ienum.MoveNext()) 
    {     
      book = (XmlNode) ienum.Current;
      Console.WriteLine(book.OuterXml);
      Console.WriteLine();
    }

  }
}

    

The example uses the file, books.xml, as input.

<?xml version='1.0'?>
<!-- This file represents a fragment of a book store inventory database -->
<bookstore>
  <book genre="autobiography" publicationdate="1981" ISBN="1-861003-11-0">
    <title>The Autobiography of Benjamin Franklin</title>
    <author>
      <first-name>Benjamin</first-name>
      <last-name>Franklin</last-name>
    </author>
    <price>8.99</price>
  </book>
  <book genre="novel" publicationdate="1967" ISBN="0-201-63361-2">
    <title>The Confidence Man</title>
    <author>
      <first-name>Herman</first-name>
      <last-name>Melville</last-name>
    </author>
    <price>11.99</price>
  </book>
  <book genre="philosophy" publicationdate="1991" ISBN="1-861001-57-6">
    <title>The Gorgias</title>
    <author>
      <name>Plato</name>
    </author>
    <price>9.99</price>
  </book>
</bookstore>

    

Return to top

Inherited
See base class member description: System.Object.GetHashCode

C# Syntax:

public virtual int GetHashCode();

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.GetNamespaceOfPrefix

Summary

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.

C# Syntax:

public virtual string GetNamespaceOfPrefix(    string prefix );

prefix

Prefix whose namespace URI you want to find

Return Value:

The namespace URI of the specified prefix.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example adds a new attribute to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Create a new attribute.
    string ns = root.GetNamespaceOfPrefix("bk");
    XmlNode attr = doc.CreateNode(XmlNodeType.Attribute, "genre", ns);
    attr.Value = "novel";

    //Add the attribute to the document.
    root.Attributes.SetNamedItem(attr);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.GetPrefixOfNamespace

Summary

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.

C# Syntax:

public virtual string GetPrefixOfNamespace(    string namespaceURI );

namespaceURI

Namespace URI whose prefix you want to find

Return Value:

The prefix for the specified namespace URI.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example adds a new element to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.FirstChild;

    //Create a new node.
    string prefix = root.GetPrefixOfNamespace("urn:samples");
    XmlElement elem = doc.CreateElement(prefix, "style", "urn:samples");
    elem.InnerText = "hardcover";

    //Add the node to the document.
    root.AppendChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Object.GetType

C# Syntax:

public Type GetType();

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.InsertAfter

Summary

Inserts the specified node immediately after the specified reference node.

C# Syntax:

public virtual XmlNode InsertAfter(    XmlNode newChild,    XmlNode refChild );

newChild

The XmlNode to insert.

refChild

The XmlNode that is the reference node. The newNode is placed after the refNode.

Return Value:

The node being inserted.

Exceptions

Exception Type	Condition
InvalidOperationException	This node is of a type that does not allow children of the type of the newChild node. Or the node to insert is one of this node's ancestors.
ArgumentException	The newChild was created from a different document than the one that created this node. The refChild is not a child of this node. This node is read-only.

If refChild is null, insert newChild at the beginning of the list of children. If newChild is an XmlDocumentFragment object, its children are inserted, in the same order, after refChild. If the newChild is already in the tree, it is first removed.

This method is a Microsoft extension to the Document Object Model (DOM).

Notes to inheritors: When overriding InsertAfter in a derived class, in order for events to be fired correctly, you must call the base class's InsertAfter method.

The following example adds a new node to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.InsertAfter(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.InsertBefore

Summary

Inserts the specified node immediately before the specified reference node.

C# Syntax:

public virtual XmlNode InsertBefore(    XmlNode newChild,    XmlNode refChild );

newChild

The XmlNode to insert.

refChild

The XmlNode that is the reference node. The newChild is placed before this node.

Return Value:

The node being inserted.

Exceptions

Exception Type	Condition
InvalidOperationException	The current node is of a type that does not allow children of the type of the newChild node. Or the node to insert is an ancestor of this node.
ArgumentException	The newChild was created from a different document than the one that created this node. The refChild is not a child of this node. This node is read-only.

If refChild is null, insert newChild at the end of the list of children. If newChild is an XmlDocumentFragment object, its children are inserted, in the same order, before refChild. If the newChild is already in the tree, it is first removed.

Notes to inheritors: When overriding InsertBefore in a derived class, in order for events to be fired correctly, you must call the base class's InsertBefore method.

The following example adds a new node to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.InsertBefore(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Object.MemberwiseClone

C# Syntax:

protected object MemberwiseClone();

For more information on members inherited from System.Object click on the link above.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Normalize

Summary

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.

C# Syntax:

public virtual void Normalize();

This method can be used to ensure that the DOM view of a document is the same as if it were saved and re-loaded, and is useful when operations (such as XPointer lookups) that depend on a particular document tree structure are to be used.

Return to top

Inherited
See base class member description: System.Xml.XmlNode.PrependChild

Summary

Adds the specified node to the beginning of the list of children of this node.

C# Syntax:

public virtual XmlNode PrependChild(    XmlNode newChild );

newChild

The node to add. If it is an XmlDocumentFragment, the entire contents of the document fragment are moved into the child list of this node.

Return Value:

The node added.

Exceptions

Exception Type	Condition
InvalidOperationException	This node is of a type that does not allow children of the type of the newChild node. Or the node to be added is one of this node's ancestors.
ArgumentException	The newChild was created from a different document than the one that created this node. Or this node is read-only.

If the newChild is already in the tree, it is first removed.

This method is a Microsoft extension to the Document Object Model (DOM).

Notes to inheritors: When overriding PrependChild in a derived class, in order for events to be fired correctly, you must call the base class's PrependChild method.

The following example adds a new node to the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new node.
    XmlElement elem = doc.CreateElement("price");
    elem.InnerText="19.95";

    //Add the node to the document.
    root.PrependChild(elem);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.RemoveAll

Summary

Removes all the children and/or attributes of the current node.

C# Syntax:

public virtual void RemoveAll();

If a removed attribute is known to have a default value, an attribute immediately appears containing the default value and, if applicable, the corresponding namespace URI, local name, and prefix.

This method is a Microsoft extension to the Document Object Model (DOM).

Notes to inheritors: When overriding RemoveAll in a derived class, in order for events to be fired correctly, you must call the base class's RemoveAll method.

The following example removes all child and attribute nodes from the root node.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Remove all attribute and child nodes.
    root.RemoveAll();

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.RemoveChild

Summary

Removes specified child node.

C# Syntax:

public virtual XmlNode RemoveChild(    XmlNode oldChild );

oldChild

The node being removed.

Return Value:

The node removed.

Exceptions

Exception Type	Condition
ArgumentException	The oldChild is not a child of this node. Or this node is read-only.

Notes to inheritors: When overriding RemoveChild in a derived class, in order for events to be fired correctly, you must call the base class's RemoveChild method.

The following example removes a node from the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Remove the title element.
    root.RemoveChild(root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.ReplaceChild

Summary

Replaces the child node oldChild with newChild node.

C# Syntax:

public virtual XmlNode ReplaceChild(    XmlNode newChild,    XmlNode oldChild );

newChild

The new node to put in the child list.

oldChild

The node being replaced in the list.

Return Value:

The node replaced.

Exceptions

Exception Type	Condition
InvalidOperationException	This node is of a type that does not allow children of the type of the newChild node. Or the node to put in is one of this node's ancestors.
ArgumentException	The newChild was created from a different document than the one that created this node. This node is read-only. The oldChild is not a child of this node.

If the newChild is already in the tree, it is first removed.

Notes to inheritors: When overriding ReplaceChild in a derived class, in order for events to be fired correctly, you must call the base class's ReplaceChild method.

The following example replaces the title element in the XML document.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.LoadXml("<book genre='novel' ISBN='1-861001-57-5'>" +
                "<title>Pride And Prejudice</title>" +
                "</book>");

    XmlNode root = doc.DocumentElement;

    //Create a new title element.
    XmlElement elem = doc.CreateElement("title");
    elem.InnerText="The Handmaid's Tale";

    //Replace the title element.
    root.ReplaceChild(elem, root.FirstChild);

    Console.WriteLine("Display the modified XML...");
    doc.Save(Console.Out);

  }
}

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.SelectNodes

Summary

Selects a list of nodes matching the XPath expression.

C# Syntax:

public XmlNodeList SelectNodes(    string xpath );

xpath

The XPath expression.

Return Value:

An XmlNodeList containing a collection of nodes matching the XPath query.

Exceptions

Exception Type	Condition
XPathException	The XPath expression contains a prefix.

If the XPath expression requires namespace resolution, you must use the SelectNodes overload which takes an XmlNamespaceManager as its argument. The XmlNamespaceManager is used to resolve namespaces.

Note If the XPath expression does not include a prefix, it is assumed that the namespace URI is the empty namespace. If your XML includes a default namespace, you must still use the XmlNamespaceManager and add a prefix and namespace URI to it; otherwise, you will not get any nodes selected.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example changes the price on all books by Jane Austen.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

    XmlDocument doc = new XmlDocument();
    doc.Load("booksort.xml");

    XmlNodeList nodeList;
    XmlNode root = doc.DocumentElement;

    nodeList=root.SelectNodes("descendant::book[author/last-name='Austen']");
 
    //Change the price on the books.
    foreach (XmlNode book in nodeList)
    {
      book.LastChild.InnerText="15.95";
    }

    Console.WriteLine("Display the modified XML document....");
    doc.Save(Console.Out);
    
  }
}

    

The example uses the file, booksort.xml, as input.

<?xml version="1.0"?>
<!-- a fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.SelectNodes

Summary

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

C# Syntax:

public XmlNodeList SelectNodes(    string xpath,    XmlNamespaceManager nsmgr );

xpath

The XPath expression.

nsmgr

An XmlNamespaceManager to use for resolving namespaces for prefixes in the XPath expression.

Return Value:

An XmlNodeList containing a collection of nodes matching the XPath query.

Exceptions

Exception Type	Condition
XPathException	The XPath expression contains a prefix which is not defined in the XmlNamespaceManager.

XPath expressions can include namespaces. Namespace resolution is supported using the XmlNamespaceManager. If the XPath expression includes a prefix, the prefix and namespace URI pair must be added to the XmlNamespaceManager.

Note If the XPath expression does not include a prefix, it is assumed that the namespace URI is the empty namespace. If your XML includes a default namespace, you must still add a prefix and namespace URI to the XmlNamespaceManager; otherwise, you will not get any nodes selected.

For example, if you had the following XML:

              <bookstore xmlns="http://www.lucernepublishing.com">
               <book>
                 <title>Pride And Prejudice</title>
               </book>
              </bookstore>
                 
            

The following C# code selects all book nodes:

              XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
              nsmgr.AddNamespace("ab", "http://www.lucernepublishing.com");
              XmlNodeList nodelist = doc.SelectNodes("//ab:book", nsmgr);
                 
            

This method is a Microsoft extension to the Document Object Model (DOM).

The following example displays the values of each of the ISBN attributes.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

      XmlDocument doc = new XmlDocument();
      doc.Load("booksort.xml");

      //Create an XmlNamespaceManager for resolving namespaces.
      XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
      nsmgr.AddNamespace("bk", "urn:samples");

      //Select and display the value of all the ISBN attributes.
      XmlNodeList nodeList;
      XmlElement root = doc.DocumentElement;
      nodeList = root.SelectNodes("/bookstore/book/@bk:ISBN", nsmgr);
      foreach (XmlNode isbn in nodeList){
        Console.WriteLine(isbn.Value);
      }

   }

}

    

The example uses the file, booksort.xml, as input.

<?xml version="1.0"?>
<!-- a fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.SelectSingleNode

Summary

Selects the first XmlNode that matches the XPath expression.

C# Syntax:

public XmlNode SelectSingleNode(    string xpath );

xpath

The XPath expression.

Return Value:

The first XmlNode that matches the XPath query or null if no matching node was found.

Exceptions

Exception Type	Condition
XPathException	The XPath expression contains a prefix.

If the XPath expression requires namespace resolution, you must use the SelectSingleNode overload which takes an XmlNamespaceManager as its argument. The XmlNamespaceManager is used to resolve namespaces.

Note If the XPath expression does not include a prefix, it is assumed that the namespace URI is the empty namespace. If your XML includes a default namespace, you must still use the XmlNamespaceManager and add a prefix and namespace URI to it; otherwise, you will not get a selected node.

This method is a Microsoft extension to the Document Object Model (DOM).

The following example changes the price of the first Jane Austen book.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {
    XmlDocument doc = new XmlDocument();
    doc.Load("booksort.xml");

    XmlNode book;
    XmlNode root = doc.DocumentElement;

    book=root.SelectSingleNode("descendant::book[author/last-name='Austen']");
 
    //Change the price on the book.
    book.LastChild.InnerText="15.95";

    Console.WriteLine("Display the modified XML document....");
    doc.Save(Console.Out);    
  }
}

    

The example uses the file, booksort.xml, as input.

<?xml version="1.0"?>
<!-- a fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.SelectSingleNode

Summary

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

C# Syntax:

public XmlNode SelectSingleNode(    string xpath,    XmlNamespaceManager nsmgr );

xpath

The XPath expression.

nsmgr

An XmlNamespaceManager to use for resolving namespaces for prefixes in the XPath expression.

Return Value:

The first XmlNode that matches the XPath query or null if no matching node was found.

Exceptions

Exception Type	Condition
XPathException	The XPath expression contains a prefix which is not defined in the XmlNamespaceManager.

XPath expressions can include namespaces. Namespace resolution is supported using the XmlNamespaceManager. If the XPath expression includes a prefix, the prefix and namespace URI pair must be added to the XmlNamespaceManager.

Note If the XPath expression does not include a prefix, it is assumed that the namespace URI is the empty namespace. If your XML includes a default namespace, you must still add a prefix and namespace URI to the XmlNamespaceManager; otherwise, you will not get a node selected.

For example, if you had the following XML:

              <bookstore xmlns="http://www.lucernepublishing.com">
               <book>
                 <title>Pride And Prejudice</title>
               </book>
              </bookstore>
                 
            

The following C# code selects the first book node:

              XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
              nsmgr.AddNamespace("ab", "http://www.lucernepublishing.com");
              XmlNode book = doc.SelectSingleNode("//ab:book", nsmgr);
                 
            

This method is a Microsoft extension to the Document Object Model (DOM).

The following example selects the book with the matching ISBN value.

using System;
using System.IO;
using System.Xml;

public class Sample
{
  public static void Main()
  {

      XmlDocument doc = new XmlDocument();
      doc.Load("booksort.xml");

      //Create an XmlNamespaceManager for resolving namespaces.
      XmlNamespaceManager nsmgr = new XmlNamespaceManager(doc.NameTable);
      nsmgr.AddNamespace("bk", "urn:samples");

      //Select the book node with the matching attribute value.
      XmlNode book;
      XmlElement root = doc.DocumentElement;
      book = root.SelectSingleNode("descendant::book[@bk:ISBN='1-861001-57-6']", nsmgr);

      Console.WriteLine(book.OuterXml);

  }
}

    

The example uses the file, booksort.xml, as input.

<?xml version="1.0"?>
<!-- a fragment of a book store inventory database -->
<bookstore xmlns:bk="urn:samples">
  <book genre="novel" publicationdate="1997" bk:ISBN="1-861001-57-8">
    <title>Pride And Prejudice</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>24.95</price>
  </book>
  <book genre="novel" publicationdate="1992" bk:ISBN="1-861002-30-1">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>29.95</price>
  </book>
  <book genre="novel" publicationdate="1991" bk:ISBN="1-861001-57-6">
    <title>Emma</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" publicationdate="1982" bk:ISBN="1-861001-45-3">
    <title>Sense and Sensibility</title>
    <author>
      <first-name>Jane</first-name>
      <last-name>Austen</last-name>
    </author>
    <price>19.95</price>
  </book>
</bookstore>

    

Return to top

Inherited
See base class member description: System.Xml.XmlNode.Supports

Summary

Test if the DOM implementation implements a specific feature.

C# Syntax:

public virtual bool Supports(    string feature,    string version );

feature

The package name of the feature to test. This name is case-insensitive.

version

This is the version number of the package name to test. If the version is not specified (null), supporting any version of the feature will cause the method to return true.

Return Value:

true if the feature is implemented in the specified version; otherwise, false. The following table describes the combinations that return true.

Feature	Version
XML	1.0
XML	2.0

Return to top

Inherited
See base class member description: System.Object.ToString

C# Syntax:

public virtual string ToString();

For more information on members inherited from System.Object click on the link above.

Return to top

Summary

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

C# Syntax:

public override void WriteContentTo(    XmlWriter w );

w

The XmlWriter to which you want to save.

This method is a Microsoft extension to the Document Object Model (DOM).

Return to top

Summary

Saves the node to the specified XmlWriter.

C# Syntax:

public override void WriteTo(    XmlWriter w );

w

The XmlWriter to which you want to save.

This method is a Microsoft extension to the Document Object Model (DOM).

Return to top

Top of page