XmlNode.Value Propriété

Définition

Espace de noms:

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

Obtient ou définit la valeur du nœud.

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

Valeur de propriété

String

La valeur retournée dépend du NodeType du nœud :

Type	Valeur
Attribut	Valeur de l'attribut.
CDATASection.	Contenu de la section CDATA.
Commentaire	Contenu du commentaire.
Document	null.
DocumentFragment	null.
DocumentType ;	null.
Élément	null. Vous pouvez utiliser les propriétés InnerText ou InnerXml pour accéder à la valeur du nœud d'élément.
Entité	null.
EntityReference	null.
Notation	null.
ProcessingInstruction ;	Contenu entier, à l'exclusion de la cible.
Texte	Contenu du nœud de texte.
SignificantWhitespace	Espaces blancs. Un espace blanc peut se composer de plusieurs espaces, retours chariots, changements de ligne ou tabulations.
Espace blanc	Espaces blancs. Un espace blanc peut se composer de plusieurs espaces, retours chariots, changements de ligne ou tabulations.
XmlDeclaration	Contenu de la déclaration (autrement dit, tout entre <?xml et ?>).

Exceptions

ArgumentException

Définition de la valeur d'un nœud qui est en lecture seule.

InvalidOperationException

Définition de la valeur d'un nœud qui n'est pas censé posséder de valeur (par exemple un nœud Element).

Exemples

L’exemple suivant ajoute un nouvel attribut au document XML et définit la Value propriété du nouvel attribut.

#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