XmlWriterSettings.NewLineHandling Свойство

Определение

Пространство имен:

System.Xml

Сборка:

System.Xml.ReaderWriter.dll

Исходный код:

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. Дополнительные правила нормализации применяются к значениям атрибутов при круговом смещении, так как \t, \n и \r заменяются пробелом в значениях атрибутов при нормализации в XmlReader.

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

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

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

Text Node Value:

	\r\n	\n	\r	\t
Entitize	&#D;\n	\n	&#D;	\t
Заменить	\r\n	\r\n	\r\n	\t
Отсутствуют	\r\n	\n	\r	\t

Attribute Value:

	\r\n	\n	\r	\t
Entitize	&#D;&#A;	&#A;	&#D;
Заменить	&#D;&#A;	&#A;	&#D;
Отсутствуют	\r\n	\n	\r	\t

Примечание

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

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

Примечание

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

	\r\n	\n	\r	\t
Значение текстового узла	\n	\n	\n	\t
Значение атрибута	один пробел	один пробел	один пробел	один пробел