XmlNode.Value Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение узла.
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
Значение свойства
Возвращаемое значение зависит от значения свойства NodeType узла.
Тип | Значение |
---|---|
Атрибут | Значение атрибута. |
CDATASection. | Содержимое раздела CDATA. |
Добавление примечаний | Содержимое комментария. |
Document | null .
|
DocumentFragment | null .
|
DocumentType; | null .
|
Элемент | null . Для доступа к значению узла элемента можно использовать свойство InnerText или InnerXml.
|
Объект | null .
|
EntityReference | null .
|
Notation | null .
|
ProcessingInstruction; | Все содержимое, исключая назначение. |
Text | Содержимое текстового узла. |
SignificantWhitespace | Символы-разделители. Символы-разделители могут включать один или более символов пробела, возврата каретки, перевода строки или табуляции. |
Whitespace | Символы-разделители. Символы-разделители могут включать один или более символов пробела, возврата каретки, перевода строки или табуляции. |
XmlDeclaration | Содержимое объявления (то есть все между <?xml и ?>). |
Исключения
Установка значения узла, доступного только для чтения.
Установка значения узла, который не должен иметь значения (например, узла элемента).
Примеры
В следующем примере добавляется новый атрибут в XML-документ и задается Value свойство нового атрибута.
#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