XmlNode::Value Property
Gets or sets the value of the node.
Assembly: System.Xml (in System.Xml.dll)
public: property String^ Value { virtual String^ get(); virtual void set(String^ value); }
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 ?>). |
| Exception | Condition |
|---|---|
| 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.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 ); }
Available since 10
.NET Framework
Available since 1.1