XmlReaderSettings.CheckCharacters Свойство

  • Ссылка

Определение

Пространство имен:
System.Xml
Сборка:
System.Xml.ReaderWriter.dll
Сборка:
System.Xml.dll
Сборка:
netstandard.dll

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

public:
 property bool CheckCharacters { bool get(); void set(bool value); };
public bool CheckCharacters { get; set; }
member this.CheckCharacters : bool with get, set
Public Property CheckCharacters As Boolean

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

Boolean

Значение true — проверка осуществляется; в противном случае — false. Значение по умолчанию — true.

Комментарии

Это свойство предписывает средству чтения XML проверять символы в считываемых XML-данных и создавать XmlException символы, если какие-либо символы находятся за пределами диапазона юридических XML-символов. Если включена проверка символов, гарантируется выполнение следующих условий.

  • Символы находятся в диапазоне юридических XML-символов, как определено в разделе 2.2 Символов рекомендации W3C XML 1.0.

  • Все имена XML допустимы, как определено в разделе 2.3 Common Syntactic Constructs рекомендации W3C XML 1.0.

Если для этого свойства задано trueзначение по умолчанию, возникает исключение, XmlException если XML-файл содержит недопустимые символы или недопустимые имена XML (например, имя элемента начинается с числа).

Если средство чтения XmlReader обрабатывает текстовые данные, всегда происходит проверка допустимости XML-имен и текстового содержимого независимо от значения этого свойства. Задание свойству CheckCharacters значения false отключает проверку символов для ссылок на сущности символов.

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