XmlTextReader.EntityHandling Свойство

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlTextReader.cs

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

public:
 property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };

public System.Xml.EntityHandling EntityHandling { get; set; }

member this.EntityHandling : System.Xml.EntityHandling with get, set

Public Property EntityHandling As EntityHandling

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

EntityHandling

Одно из значений EntityHandling . Если значение не EntityHandling указано, по умолчанию используется EntityHandling.ExpandCharEntitiesзначение .

Комментарии

Замечание

Рекомендуем создавать XmlReader экземпляры с помощью XmlReader.Create метода, чтобы воспользоваться новыми функциями.

Это свойство можно изменить на лету и вступает в силу после следующего Read вызова.

Если EntityHandling задано значение ExpandCharEntities, значения атрибутов только частично нормализуются. Средство чтения нормализует каждый отдельный текстовый узел независимо от содержимого смежных ссылочных узлов сущностей.

Чтобы проиллюстрировать разницу между режимами обработки сущностей, рассмотрим следующий XML-код:

<!DOCTYPE doc [<!ENTITY num "123">]>
    <doc> &#65; &num; </doc>

Если EntityHandling задано значение ExpandEntities "doc", узел элемента содержит один текстовый узел с расширенным текстом сущности:

Глубина	Тип узла	Имя	Ценность
1	Text		A 123

Если EntityHandling задано значение , и WhitespaceHandlingSignificant задано ExpandCharEntitiesзначение или Allэлемент doc расширяет символьную сущность и возвращает общую сущность в качестве узла:

Глубина	Тип узла	Имя	Ценность
1	Text		A
1	EntityReference	число
1	SignificantWhitespace

См. также раздел

• XmlReader