XmlNode.Value XmlNode.Value XmlNode.Value XmlNode.Value Property

Definition

Ruft den Wert des Knotens ab oder legt diesen fest.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

Eigenschaftswert

Der zurückgegebene Wert hängt vom NodeType des Knotens ab:The value returned depends on the NodeType of the node:

TypType WertValue
AttributAttribute Der Wert des Attributs.The value of the attribute.
CDATASectionCDATASection Der Inhalt des CDATA-Abschnitts.The content of the CDATA Section.
KommentarComment Der Inhalt des Kommentars.The content of the comment.
DokumentDocument null.null.
DocumentFragmentDocumentFragment null.null.
DocumentTypeDocumentType null.null.
ElementElement null.null. Sie können mit der InnerText-Eigenschaft oder der InnerXml-Eigenschaft auf den Wert des Elementknotens zugreifen.You can use the InnerText or InnerXml properties to access the value of the element node.
EntitätEntity null.null.
EntityReferenceEntityReference null.null.
NotationNotation null.null.
ProcessingInstructionProcessingInstruction Der gesamte Inhalt mit Ausnahme des Ziels.The entire content excluding the target.
TextText Der Inhalt des Textknotens.The content of the text node.
SignificantWhitespaceSignificantWhitespace Die Leerraumzeichen.The white space characters. Leerraum kann aus einem oder mehreren Leerzeichen, Wagenrückläufen, Zeilenvorschüben und Tabstopps bestehen.White space can consist of one or more space characters, carriage returns, line feeds, or tabs.
WhitespaceWhitespace Die Leerraumzeichen.The white space characters. Leerraum kann aus einem oder mehreren Leerzeichen, Wagenrückläufen, Zeilenvorschüben und Tabstopps bestehen.White space can consist of one or more space characters, carriage returns, line feeds, or tabs.
XmlDeclarationXmlDeclaration Der Inhalt der Deklaration (d. h. alles zwischen <? XML und? >).The content of the declaration (that is, everything between <?xml and ?>).

Ausnahmen

Festlegen des Werts eines schreibgeschützten Knotens.Setting the value of a node that is read-only.

Festlegen des Werts eines Knotens, der normalerweise keinen Wert besitzt (z. B. ein Elementknoten).Setting the value of a node that is not supposed to have a value (for example, an Element node).

Beispiele

Im folgenden Beispiel wird dem XML-Dokument ein neues Attribut hinzugefügt und die Value-Eigenschaft des neuen Attributs festgelegt.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

Gilt für: