XmlNode.Value Eigenschaft

Definition

Namespace:

System.Xml

Assemblys:

System.Xml.dll, System.Xml.XmlDocument.dll

Assembly:

System.Xml.ReaderWriter.dll

Assembly:

System.Xml.XmlDocument.dll

Assembly:

System.Xml.dll

Assembly:

netstandard.dll

Ruft den Wert des Knotens ab oder legt diesen fest.

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

Eigenschaftswert

String

Der zurückgegebene Wert hängt vom NodeType des Knotens ab:

type	Wert
attribute	Der Wert des Attributs.
CDATASection	Der Inhalt des CDATA-Abschnitts.
Kommentar	Der Inhalt des Kommentars.
Dokument	null.
DocumentFragment	null.
DocumentType	null.
Element	null. Sie können mit der InnerText-Eigenschaft oder der InnerXml-Eigenschaft auf den Wert des Elementknotens zugreifen.
Entität	null.
EntityReference	null.
Notation	null.
ProcessingInstruction	Der gesamte Inhalt mit Ausnahme des Ziels.
Text	Der Inhalt des Textknotens.
SignificantWhitespace	Die Leerraumzeichen. Leerraum kann aus einem oder mehreren Leerzeichen, Wagenrückläufen, Zeilenvorschüben und Tabstopps bestehen.
Leerraum	Die Leerraumzeichen. Leerraum kann aus einem oder mehreren Leerzeichen, Wagenrückläufen, Zeilenvorschüben und Tabstopps bestehen.
XmlDeclaration	Der Inhalt der Deklaration (also alles zwischen <?xml und ?>).

Ausnahmen

ArgumentException

Festlegen des Werts eines schreibgeschützten Knotens.

InvalidOperationException

Festlegen des Werts eines Knotens, der normalerweise keinen Wert besitzt (z. B. ein Elementknoten).

Beispiele

Im folgenden Beispiel wird dem XML-Dokument ein neues Attribut hinzugefügt und die Value Eigenschaft des neuen Attributs festgelegt.

#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