XDocument.Declaration Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает xml-объявление для этого документа.
public:
property System::Xml::Linq::XDeclaration ^ Declaration { System::Xml::Linq::XDeclaration ^ get(); void set(System::Xml::Linq::XDeclaration ^ value); };public System.Xml.Linq.XDeclaration Declaration { get; set; }public System.Xml.Linq.XDeclaration? Declaration { get; set; }member this.Declaration : System.Xml.Linq.XDeclaration with get, setPublic Property Declaration As XDeclarationЗначение свойства
Объект XDeclaration , содержащий xml-объявление для этого документа.
Примеры
В следующем примере используется это свойство для получения xml-объявления документа.
XDocument doc = new XDocument(
new XDeclaration("1.0", "utf-8", "yes"),
new XComment("This is a comment"),
new XElement("Root", "content")
);
Console.WriteLine(doc.Declaration);
Dim doc As XDocument = _
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<!--This is a comment-->
<Root>content</Root>
Console.WriteLine(doc.Declaration)
В примере получается следующий вывод.
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
Комментарии
Иногда необходимо создать xml-объявление для документа. Если вы хотите указать, что документ является автономным, необходимо использовать это свойство. Если вы хотите закодировать документ с кодировкой, отличной от utf-8, можно указать кодировку с помощью XDeclaration. Другой подход к кодированию документа — указать кодировку XmlWriter , передаваемую в LINQ to XML для записи.
