XmlNode.Value Property

Reference

Definition

Namespace:: System.Xml

Assemblies:: System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:: System.Xml.ReaderWriter.dll

Assembly:: System.Xml.XmlDocument.dll

Assembly:: System.Xml.dll

Assembly:: netstandard.dll

Source:: XmlNode.cs

Source:: XmlNode.cs

Source:: XmlNode.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets the value of the node.

public:
 virtual property System::String ^ Value { System::String ^ get(); void set(System::String ^ value); };

public virtual string Value { get; set; }

public virtual string? Value { get; set; }

member this.Value : string with get, set

Public Overridable Property Value As String

Property Value

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 InnerText or 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 ?>).

Exceptions

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

Examples

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

#using <System.Xml.dll>

using namespace System;
using namespace System::IO;
using namespace System::Xml;
int main()
{
   XmlDocument^ doc = gcnew 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 );
}

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

Option Strict
Option Explicit

Imports System.IO
Imports System.Xml

Public Class Sample
    
    Public Shared Sub Main()
        
        Dim doc As New XmlDocument()
        doc.LoadXml("<book xmlns:bk='urn:samples' bk:ISBN='1-861001-57-5'>" & _
                    "<title>Pride And Prejudice</title>" & _
                    "</book>")
        
        Dim root As XmlNode = doc.FirstChild
        
        'Create a new attribute.
        Dim ns As String = root.GetNamespaceOfPrefix("bk")
        Dim attr As XmlNode = 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)
    End Sub
End Class

Applies to

Partilhar via