Форматирование выходных XML-данных с помощью XmlTextWriter
Форматирование выходных XML-данных с помощью XmlTextWriter состоит из нескольких свойств, которые вместе управляют выводом документа.
Форматирование выходных XML-данных с помощью XmlTextWriter состоит из нескольких свойств, которые вместе управляют выводом документа. Для форматирования выхода предназначены следующие свойства:
Форматирование
IndentChar;
Indentation;
QuoteChar.
Форматирование выхода
Для свойства Formatting допустимы значения None и Indented. По умолчанию используется значение None. Если выбрано значение None, то свойства IndentChar и Indentation не учитываются, и форматирование не выполняется. Если свойство Formatting имеет значение Indented, то приложение проверяет значение свойства Indentation, чтобы определить, сколько символов IndentChars нужно записать для каждого уровня иерархии, а затем по свойству IndentChars определяет, какой символ использовать для отступов. Если свойство Formatting имеет значение Indented, то по умолчанию свойство Indentation задает запись двух символов IndentChars для каждого уровня иерархии, а значением свойства IndentChars по умолчанию является пробел. Если свойство Formatting имеет значение Indented, дочерние элементы располагаются с отступом в соответствии со значениями свойств Indentation и IndentChar. Величина отступа, назначаемая XmlTextWriter, зависит от типа узла. Свойство Indentation влияет на следующие узлы:
DocumentType;
элементы;
комментарии;
ProcessingInstruction;
CDATASection.
Для всех остальных типов узлов свойство Indentation не действует и отступы не выполняются.
Встроенный DTD не содержит отступов и форматирования, однако допускает форматирование, что показано в примере кода. В примере кода выполняется форматирование встроенного DTD.
String name = "Employees";
String pubid = null;
String sysid = null;
String subset = @"
<!ELEMENT Employees (Employee)+>
<!ELEMENT Employee EMPTY>
<!ATTLIST Employee firstname CDATA #REQUIRED>
<!ENTITY Company 'Microsoft'>]>
";
XmlTextWriter tw = new XmlTextWriter(Console.Out);
tw.WriteDocType(name, pubid, sysid, subset);
Свойство QuoteChar определяет, какой символ используется для заключения значений атрибутов в кавычки. Допустимые значения:
одинарная кавычка (');
двойная кавычка (").
По умолчанию в свойстве QuoteChar указывается двойная кавычка (").
Пример
В следующем примере записывается XML-фрагмент со свойством Formatting в значении Indented, уровнем отступа 4 и пробелом в качестве символа отступа (значения по умолчанию).
Option Explicit
Option Strict
Imports System
Imports System.IO
Imports System.Xml
Public Class Sample
Public Shared Sub Main()
'Create a writer to write XML to the console.
Dim writer As XmlTextWriter = Nothing
writer = New XmlTextWriter(Console.Out)
'Use indentation for readability.
writer.Formatting = Formatting.Indented
writer.Indentation = 4
'Write an element (this one is the root).
writer.WriteStartElement("book")
'Write the title element.
writer.WriteStartElement("title")
writer.WriteString("Pride And Prejudice")
writer.WriteEndElement()
'Write the close tag for the root element.
writer.WriteEndElement()
'Write the XML to file and close the writer.
writer.Close()
End Sub 'Main
End Class 'Sample
using System;
using System.IO;
using System.Xml;
public class Sample
{
public static void Main()
{
//Create a writer to write XML to the console.
XmlTextWriter writer = null;
writer = new XmlTextWriter (Console.Out);
//Use indentation for readability.
writer.Formatting = Formatting.Indented;
writer.Indentation = 4;
//Write an element (this one is the root).
writer.WriteStartElement("book");
//Write the title element.
writer.WriteStartElement("title");
writer.WriteString("Pride And Prejudice");
writer.WriteEndElement();
//Write the close tag for the root element.
writer.WriteEndElement();
//Write the XML to file and close the writer.
writer.Close();
}
}