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


XmlTextReader.EntityHandling Свойство

Определение

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

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.ExpandCharEntities.

Комментарии

Примечание

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

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

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

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

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

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

Глубина Тип узла Имя Значение
1 Text A 123

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

Глубина Тип узла Имя Значение
1 Text Объект
1 EntityReference num
1 SignificantWhitespace

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

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