XmlValidatingReader.EntityHandling Свойство

Определение

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

System.Xml

Сборки:

netstandard.dll, System.Xml.ReaderWriter.dll

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

XmlValidatingReader.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.ExpandEntities.

Исключения

ArgumentOutOfRangeException

Указано недопустимое значение.

Комментарии

Замечание

Класс XmlValidatingReader устарел в .NET Framework 2.0. Вы можете создать проверяющий XmlReader экземпляр с помощью XmlReaderSettings класса и Create метода. Дополнительные сведения см. в подразделе "Примечания" на справочной странице XmlReader.

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

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

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

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

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

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

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

Глубина	NodeType	Имя	Ценность
1	Текст		A
1	EntityReference	число
1	ЗначащиеПробелы (SignificantWhitespace)

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

• XmlReader