XmlNode.Value Propriedade

  • Referência

Definição

Namespace:
System.Xml
Assemblies:
System.Xml.dll, System.Xml.XmlDocument.dll
Assembly:
System.Xml.ReaderWriter.dll
Assembly:
System.Xml.XmlDocument.dll
Assembly:
System.Xml.dll
Assembly:
netstandard.dll

Obtém ou define o valor do nó.

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

Valor da propriedade

String

O valor retornado depende do NodeType do nó:

Tipo Valor
Atributo O valor do atributo.
CDATASection O conteúdo da seção CDATA.
Comentário O conteúdo do comentário.
Documento null.
DocumentFragment null.
DocumentType null.
Elemento null. Você pode usar as propriedades InnerText ou InnerXml para acessar o valor do nó do elemento.
Entidade null.
EntityReference null.
Notation null.
ProcessingInstruction Todo o conteúdo, exceto o destino.
Texto O conteúdo do nó de texto.
SignificantWhitespace Os caracteres de espaço em branco. O espaço em branco pode consistir em um ou mais caracteres de espaço, retornos de carro, alimentação de linha ou tabulações.
Espaço em branco Os caracteres de espaço em branco. O espaço em branco pode consistir em um ou mais caracteres de espaço, retornos de carro, alimentação de linha ou tabulações.
XmlDeclaration O conteúdo da declaração (ou seja, tudo entre <?xml e ?>).

Exceções

ArgumentException

Definindo o valor de um nó que é somente leitura.

InvalidOperationException

Definindo o valor de um nó que não deveria ter um valor (por exemplo, um nó de elemento).

Exemplos

O exemplo a seguir adiciona um novo atributo ao documento XML e define a Value propriedade do novo atributo.

#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

Aplica-se a