XmlNamedNodeMap.SetNamedItem Method (XmlNode)


Adds an XmlNode using its Name property.

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public virtual XmlNode SetNamedItem(
	XmlNode node


Type: System.Xml.XmlNode

An XmlNode to store in the XmlNamedNodeMap. If a node with that name is already present in the map, it is replaced by the new one.

Return Value

Type: System.Xml.XmlNode

If the node replaces an existing node with the same name, the old node is returned; otherwise, null is returned.

Exception Condition

The node was created from a different XmlDocument than the one that created the XmlNamedNodeMap; or the XmlNamedNodeMap is read-only.

The following example uses the XmlAttributeCollection class (which inherits from XmlNamedNodeMap) to add an attribute to the collection.

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

public class Sample
  public static void Main()
     XmlDocument doc = new XmlDocument();
     doc.LoadXml("<book genre='novel' publicationdate='1997'> " +
                 "  <title>Pride And Prejudice</title>" +

     XmlAttributeCollection attrColl = doc.DocumentElement.Attributes;

     // Add a new attribute to the collection.
     XmlAttribute attr = doc.CreateAttribute("style");
     attr.Value = "hardcover";

     Console.WriteLine("Display the modified XML...");


Universal Windows Platform
Available since 10
.NET Framework
Available since 1.1
Return to top