Поделиться через

XmlWriterSettings.NewLineHandling Свойство

Определение

Пространство имен:
System.Xml
Сборки:
System.Xml.dll, System.Xml.ReaderWriter.dll
Сборки:
netstandard.dll, System.Xml.ReaderWriter.dll
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll
Исходный код:
XmlWriterSettings.cs
Исходный код:
XmlWriterSettings.cs
Исходный код:
XmlWriterSettings.cs
Исходный код:
XmlWriterSettings.cs
Исходный код:
XmlWriterSettings.cs

Возвращает или задает значение, указывающее, следует ли нормализовать разрывы строк в выходных данных.

public:
 property System::Xml::NewLineHandling NewLineHandling { System::Xml::NewLineHandling get(); void set(System::Xml::NewLineHandling value); };
public System.Xml.NewLineHandling NewLineHandling { get; set; }
member this.NewLineHandling : System.Xml.NewLineHandling with get, set
Public Property NewLineHandling As NewLineHandling

Значение свойства

NewLineHandling

Одно из значений NewLineHandling . Значение по умолчанию — Replace.

Комментарии

Этот параметр применяется при написании текстового содержимого или значений атрибутов. Каждое из значений NewLineHandling описано ниже:

  • Параметр Entitize указывает XmlWriter заменить новые символы строки, которые не будут сохранены в противном случае нормализацией XmlReader с сущностями символов. Это полезно в сценариях кругового пути, в которых выходные данные считываются нормализацией XmlReader. Дополнительные правила нормализации применяются к значениям атрибутов при перемещении по кругу, \n так как \tи \r заменяются пробелом в значениях атрибутов при нормализации в объектеXmlReader.

  • Параметр Replace указывает XmlWriter заменить новые символы строки символами, определенными в свойстве NewLineChars . Этот параметр также заменяет новые строки в атрибутах сущностями символов, чтобы сохранить символы. Это также значение по умолчанию.

  • Параметр None указывает XmlWriter оставить входные данные без изменений. Этот параметр используется, если не требуется никакой обработки новой строки. Это полезно, если выходные данные считываются без XmlReader нормализации (например, XmlTextReader с параметрами по умолчанию).

В следующих таблицах отображаются выходные данные метода при указании входного WriteString значения в зависимости от NewLineHandling параметра свойства. В таблицах отображаются выходные данные при написании текстового содержимого, а также при написании значения атрибута.

Значение текстового узла:

NewLineHandling \r\n \n \r \t
Entitize &#D;\n \n &#D; \t
Replace \r\n \r\n \r\n \t
None \r\n \n \r \t

Значение атрибута:

NewLineHandling \r\n \n \r \t
Entitize &#D;&#A; &#A; &#D;
Replace &#D;&#A; &#A; &#D;
None \r\n \n \r \t

Замечание

При XmlWriter написании содержимого в разделе CDATA, комментарии или инструкции по обработке имеет следующее поведение. Новые строки никогда не заменяются своими сущностями символов, даже если NewLineHandling для свойства задано значение Entitize. Это связано с тем, что сущности символов не распознаются в разделах CDATA, комментариях или инструкциях по обработке. NewLineHandling Если для свойства задано None значение или Replaceповедение совпадает с поведением при написании значения текстового узла.

В следующей таблице описывается, что возвращает нормализацию XmlReader для каждого ввода пробела. Дополнительные сведения см. в разделах 2.11 и 3.3.3 рекомендации W3C XML 1.0.

Тип значения \r\n \n \r \t
Текстовый узел \n \n \n \t
Атрибут одно пространство одно пространство одно пространство одно пространство

Замечание

Средство чтения нормализации — это любой XmlReader объект, созданный методом XmlReader.Create . Эти объекты всегда выполняют нормализацию разрывов строк и полную нормализацию атрибутов. Объект XmlTextReader также может быть нормализованным средством чтения, если для его Normalization свойства задано значение true.

Применяется к