XmlReaderSettings.CheckCharacters Свойство
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, показывающее, осуществляется ли проверка символов.
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
Значение 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
отключает проверку символов для ссылок на сущности символов.