Export (0) Print
Expand All

XmlTextReader.Value Property

Gets the text value of the current node.

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

'Declaration
Public Overrides ReadOnly Property Value As String

Property Value

Type: System.String
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 within an xml:space= 'preserve' scope.

Text

The content of the text node.

Whitespace

The white space between markup.

XmlDeclaration

The content of the declaration.

NoteNote

Starting with the .NET Framework 2.0, we recommend that you create XmlReader instances by using the XmlReader.Create method to take advantage of new functionality.

The following example reads an XML file and displays each node.

Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml

'Reads an XML document 
Public Class Sample
    Private Const filename As String = "items.xml" 

    Public Shared Sub Main()
        Dim reader As XmlTextReader = Nothing 

        Try 
            ' Load the reader with the data file and ignore all white space nodes.         
            reader = New XmlTextReader(filename)
            reader.WhitespaceHandling = WhitespaceHandling.None

            ' Parse the file and display each of the nodes. 
            While reader.Read()
                Select Case reader.NodeType
                    Case XmlNodeType.Element
                        Console.Write("<{0}>", reader.Name)
                    Case XmlNodeType.Text
                        Console.Write(reader.Value)
                    Case XmlNodeType.CDATA
                        Console.Write("<![CDATA[{0}]]>", reader.Value)
                    Case XmlNodeType.ProcessingInstruction
                        Console.Write("<?{0} {1}?>", reader.Name, reader.Value)
                    Case XmlNodeType.Comment
                        Console.Write("<!--{0}-->", reader.Value)
                    Case XmlNodeType.XmlDeclaration
                        Console.Write("<?xml version='1.0'?>")
                    Case XmlNodeType.Document
                    Case XmlNodeType.DocumentType
                        Console.Write("<!DOCTYPE {0} [{1}]", reader.Name, reader.Value)
                    Case XmlNodeType.EntityReference
                        Console.Write(reader.Name)
                    Case XmlNodeType.EndElement
                        Console.Write("</{0}>", reader.Name)
                End Select 
            End While 

        Finally 
            If Not (reader Is Nothing) Then
                reader.Close()
            End If 
        End Try 
    End Sub 'Main 
End Class 'Sample

The sample uses the file items.xml.


<?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 an char entity: &#65;</Item>
  <!-- Fourteen chars in this element.-->
  <Item>1234567890ABCD</Item>
</Items>

.NET Framework

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

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

XNA Framework

Supported in: 3.0, 2.0, 1.0
Show:
© 2015 Microsoft