Задает набор функций, которые должны поддерживаться объектом XmlWriter, создаваемым с помощью метода XmlWriter.Create.
System.Xml.XmlWriterSettings
Пространство имен: System.Xml
Сборка: System.Xml (в System.Xml.dll)
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _ Public NotInheritable Class XmlWriterSettings
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")] public sealed class XmlWriterSettings
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")] public ref class XmlWriterSettings sealed
[<Sealed>] [<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")>] type XmlWriterSettings = class end
Тип XmlWriterSettings предоставляет следующие члены.
| Имя | Описание | |
|---|---|---|
|
XmlWriterSettings | Инициализирует новый экземпляр класса XmlWriterSettings. |
| Имя | Описание | |
|---|---|---|
|
|
CheckCharacters | Возвращает или задает значение, показывающее, осуществляется ли проверка символов. |
|
|
CloseOutput | Возвращает или задает значение, указывающее, следует ли объекту XmlWriter закрывать также и основной поток или TextWriter при вызове метода Close. |
|
|
ConformanceLevel | Возвращает или задает уровень соответствия для XmlWriter. |
|
|
Encoding | Получает или задает тип используемой кодировки текста. |
|
|
Indent | Возвращает или задает значение, указывающее, следует ли использовать отступ для элементов. |
|
|
IndentChars | Возвращает или задает строку символов, которую следует использовать при отступах. Этот параметр используется, если значение свойства Indent равно true. |
|
|
NamespaceHandling | Получает или задает значение, указывающие, должен ли объект XmlWriter при записи содержимого XML удалять дубликаты объявлений пространств имен. По умолчанию объект записи выводит объявления пространств имен, присутствующие в его распознавателе пространств имен. |
|
|
NewLineChars | Возвращает или задает строку символов, которую следует использовать для разрывов строк. |
|
|
NewLineHandling | Возвращает или задает значение, показывающее, осуществляется нормализация разрывов строк в выходных данных. |
|
|
NewLineOnAttributes | Возвращает или задает значение, указывающее, следует ли записывать атрибуты в новой строке. |
|
|
OmitXmlDeclaration | Возвращает или задает значение, определяющее, следует ли записывать XML-объявление. |
|
|
OutputMethod | Возвращает метод, используемый для сериализации выходных данных объекта XmlWriter. |
| Имя | Описание | |
|---|---|---|
|
|
Clone | Создает копию экземпляра XmlWriterSettings. |
|
|
Equals(Object) | Определяет, равен ли заданный объект Object текущему объекту Object. (Унаследовано от Object.) |
|
|
Finalize | Позволяет объекту попытаться освободить ресурсы и выполнить другие операции очистки, перед тем как объект будет утилизирован в процессе сборки мусора. (Унаследовано от Object.) |
|
|
GetHashCode | Играет роль хэш-функции для определенного типа. (Унаследовано от Object.) |
|
|
GetType | Возвращает объект Type для текущего экземпляра. (Унаследовано от Object.) |
|
|
MemberwiseClone | Создает неполную копию текущего объекта Object. (Унаследовано от Object.) |
|
|
Reset | Повторно загружает значения по умолчанию для элементов класса параметров. |
|
|
ToString | Возвращение строки, представляющей текущий объект. (Унаследовано от Object.) |
Метод Create является предпочтительным механизмом для получения экземпляров XmlWriter. Метод Create использует класс XmlWriterSettings, чтобы указать, какие возможности нужно реализовать в созданном объекте XmlWriter.
|
Примечание
|
|---|
|
Если XmlWriter используется вместе с методом Transform, необходимо использовать свойство OutputSettings для получения объекта XmlWriterSettings с верными параметрами. Это гарантирует правильность параметров выходных данных для объекта XmlWriter. |
Дополнительные сведения см. в разделе Создание модуля записи XML.
В следующем примере создается XmlWriter, который записывает данные в XML-файл и записывает каждый атрибут на новой строке.
Dim settings As XmlWriterSettings = New XmlWriterSettings() settings.Indent = true settings.OmitXmlDeclaration = true settings.NewLineOnAttributes = true writer = XmlWriter.Create(Console.Out, settings) writer.WriteStartElement("order") writer.WriteAttributeString("orderID", "367A54") writer.WriteAttributeString("date", "2001-05-03") writer.WriteElementString("price", "19.95") writer.WriteEndElement() writer.Flush()
XmlWriterSettings settings = new XmlWriterSettings(); settings.Indent = true; settings.OmitXmlDeclaration = true; settings.NewLineOnAttributes = true; writer = XmlWriter.Create(Console.Out, settings); writer.WriteStartElement("order"); writer.WriteAttributeString("orderID", "367A54"); writer.WriteAttributeString("date", "2001-05-03"); writer.WriteElementString("price", "19.95"); writer.WriteEndElement(); writer.Flush();
В результате выполнения примера получается следующий результат:
<order orderID="367A54" date="2001-05-03"> <price>19.95</price> </order>
.NET Framework
Поддерживается в версиях: 4, 3.5, 3.0, 2.0.NET Framework (клиентский профиль)
Поддерживается в версиях: 4, 3.5 SP1Поддерживается в версии:
Windows 7, Windows Vista с пакетом обновления 1 (SP1) или выше, Windows XP с пакетом обновления 3 (SP3), 64-разрядный выпуск Windows XP с пакетом обновления 2 (SP2), Windows Server 2008 (Server Core не поддерживается), Windows Server 2008 R2 (Server Core поддерживается с пакетом обновления 1 (SP1) или более поздним), Windows Server 2003 SP2
.NET Framework поддерживает не все версии каждой платформы. Поддерживаемые версии перечислены в разделе Требования к системе для .NET Framework.