Export (0) Print
Expand All

XmlNodeReader.Value Property

Gets the text value of the current node.

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

public override string Value { get; }
/** @property */
public String get_Value ()

public override function get Value () : String

Not applicable.

Property Value

The value returned depends on the NodeType of the node. The following table lists node types that have a value to return. All other node types return String.Empty.

Node Type

Value

Attribute

The value of the attribute.

CDATA

The content of the CDATA section.

Comment

The content of the comment.

DocumentType

The internal subset.

ProcessingInstruction

The entire content, excluding the target.

SignificantWhitespace

The white space between markup in a mixed content model.

Text

The content of the text node.

Whitespace

The white space between markup.

XmlDeclaration

The content of the declaration.

NoteNote:

In the Microsoft .NET Framework version 2.0, the recommended practice is to create XmlReader instances using the XmlReaderSettings class and the Create method. This allows you to take full advantage of all the new features introduced in the .NET Framework. For more information, see Creating XML Readers.

The following example reads an XML and displays each node.

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

public class Sample
{
  private const String filename = "items.xml";

  public static void Main()
  {
    XmlNodeReader reader = null;

    try
    {           
        //Create an XmlNodeReader to read the XmlDocument.
        XmlDocument doc = new XmlDocument();
        doc.Load(filename);
        reader = new XmlNodeReader(doc);

        //Parse the file and display each of the nodes.
        while (reader.Read())
        {
           switch (reader.NodeType)
           {
             case XmlNodeType.Element:
               Console.Write("<{0}>", reader.Name);
               break;
             case XmlNodeType.Text:
               Console.Write(reader.Value);
               break;
             case XmlNodeType.CDATA:
               Console.Write(reader.Value);
               break;
             case XmlNodeType.ProcessingInstruction:
               Console.Write("<?{0} {1}?>", reader.Name, reader.Value);
               break;
             case XmlNodeType.Comment:
               Console.Write("<!--{0}-->", reader.Value);
               break;
             case XmlNodeType.XmlDeclaration:
               Console.Write("<?xml version='1.0'?>");
               break;
             case XmlNodeType.Document:
               break;
             case XmlNodeType.EndElement:
               Console.Write("</{0}>", reader.Name);
               break;
           }       
          }           
        }

     finally
     {
       if (reader!=null)
         reader.Close();
     }
  }
} // End class

import System.*;
import System.IO.*;
import System.Xml.*;

public class Sample
{
    private static String fileName = "items.xml";
    public static void main(String[] args)
    {
        XmlNodeReader reader = null;
        try {
            //Create an XmlNodeReader to read the XmlDocument.
            XmlDocument doc = new XmlDocument();
            doc.Load(fileName);
            reader = new XmlNodeReader(doc);

            //Parse the file and display each of the nodes.
            while (reader.Read()) {
                switch (reader.get_NodeType()) {
                    case XmlNodeType.Element :
                        Console.Write("<{0}>", reader.get_Name());
                        break;

                    case XmlNodeType.Text :
                        Console.Write(reader.get_Value());
                        break;

                    case XmlNodeType.CDATA :
                        Console.Write(reader.get_Value());
                        break;

                    case XmlNodeType.ProcessingInstruction :
                        Console.Write("<?{0} {1}?>", reader.get_Name(), 
                            reader.get_Value());
                        break;

                    case XmlNodeType.Comment :
                        Console.Write("<!--{0}-->", reader.get_Value());
                        break;

                    case XmlNodeType.XmlDeclaration :
                        Console.Write("<?xml version='1.0'?>");
                        break;

                    case XmlNodeType.Document :
                        break;

                    case XmlNodeType.EndElement :
                        Console.Write("</{0}>", reader.get_Name());
                        break;
                }
            }
        } 
        finally {
            if (reader != null) {
                reader.Close();
            }
        }
    } //main
} //End class Sample

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


<?xml version="1.0"?>
<!-- This is a sample XML document -->
<!DOCTYPE Items [<!ENTITY number "123">]>
<Items>
  <Item>Test with an entity: &number;</Item>
  <Item>test with a child element <more/> stuff</Item>
  <Item>test with a CDATA section <![CDATA[<456>]]> def</Item>
  <Item>Test with a char entity: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

Windows 98, Windows Server 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

.NET Framework

Supported in: 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 2.0, 1.0

XNA Framework

Supported in: 1.0

Community Additions

ADD
Show:
© 2014 Microsoft