XmlNode.Value Свойство

Определение

Возвращает или задает значение узла.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; }
member this.Value : string with get, set
Public Overridable Property Value As String

Значение свойства

Возвращаемое значение зависит от значения свойства NodeType узла.The value returned depends on the NodeType of the node:

ТипType ЗначениеValue
АтрибутAttribute Значение атрибута.The value of the attribute.
CDATASection.CDATASection Содержимое раздела CDATA.The content of the CDATA Section.
КомментарийComment Содержимое комментария.The content of the comment.
DocumentDocument null.null.
DocumentFragmentDocumentFragment null.null.
DocumentType;DocumentType null.null.
ЭлементElement null.null. Для доступа к значению узла элемента можно использовать свойство InnerText или InnerXml.You can use the InnerText or InnerXml properties to access the value of the element node.
ОбъектEntity null.null.
EntityReferenceEntityReference null.null.
NotationNotation null.null.
ProcessingInstruction;ProcessingInstruction Все содержимое, исключая назначение.The entire content excluding the target.
TextText Содержимое текстового узла.The content of the text node.
SignificantWhitespaceSignificantWhitespace Символы-разделители.The white space characters. Символы-разделители могут включать один или более символов пробела, возврата каретки, перевода строки или табуляции.White space can consist of one or more space characters, carriage returns, line feeds, or tabs.
WhitespaceWhitespace Символы-разделители.The white space characters. Символы-разделители могут включать один или более символов пробела, возврата каретки, перевода строки или табуляции.White space can consist of one or more space characters, carriage returns, line feeds, or tabs.
XmlDeclarationXmlDeclaration Содержимое объявления (т. е. все между <? XML и? >).The content of the declaration (that is, everything between <?xml and ?>).

Исключения

Установка значения узла, доступного только для чтения.Setting the value of a node that is read-only.

Установка значения узла, который не должен иметь значения (например, узла элемента).Setting the value of a node that is not supposed to have a value (for example, an Element node).

Примеры

В следующем примере в XML-документ добавляется новый атрибут и задается свойство Value нового атрибута.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

Применяется к