XmlNode.Value Property

Gets or sets the value of the node.

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

public virtual string Value { get; set; }

Property Value

Type: System.String
The value returned depends on the NodeType of the node:

Type

Value

Attribute

The value of the attribute.

CDATASection

The content of the CDATA Section.

Comment

The content of the comment.

Document

null.

DocumentFragment

null.

DocumentType

null.

Element

null. You can use the XmlElement.InnerText or XmlElement.InnerXml properties to access the value of the element node.

Entity

null.

EntityReference

null.

Notation

null.

ProcessingInstruction

The entire content excluding the target.

Text

The content of the text node.

SignificantWhitespace

The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs.

Whitespace

The white space characters. White space can consist of one or more space characters, carriage returns, line feeds, or tabs.

XmlDeclaration

The content of the declaration (that is, everything between <?xml and ?>).

ExceptionCondition
ArgumentException

Setting the value of a node that is read-only.

InvalidOperationException

Setting the value of a node that is not supposed to have a value (for example, an Element node).

The following example adds a new attribute to the XML document and sets the Value property of the new attribute.

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);

  }
}

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft