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. |
| Комментарий | Содержимое комментария. |
| Документа |
null.
|
| DocumentFragment |
null.
|
| DocumentType |
null.
|
| Элемент |
null. Для доступа к значению узла элемента можно использовать InnerText или InnerXml свойства.
|
| Сущность |
null.
|
| Entityreference |
null.
|
| Нотации |
null.
|
| ProcessingInstruction | Все содержимое, за исключением целевого объекта. |
| Текст | Содержимое текстового узла. |
| SignificantWhitespace | Символы пробелов. Пробел может состоять из одного или нескольких пробелов, возвращаемых каретки, веб-каналов или вкладок. |
| Пробелы | Символы пробелов. Пробел может состоять из одного или нескольких пробелов, возвращаемых каретки, веб-каналов или вкладок. |
| XmlDeclaration | Содержимое объявления (т. е. все между <?xml и ?>). |
Исключения
Задание значения узла, доступного только для чтения.
Задание значения узла, который не должен иметь значение (например, узел элемента).
Примеры
Следующий пример добавляет новый атрибут в XML-документ и задает Value свойство нового атрибута.
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