XmlReaderSettings.CheckCharacters 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置一个值,该值指示是否执行字符检查。
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 字符范围内,由 W3C XML 1.0 建议的 2.2 个字符 部分定义。
所有 XML 名称都有效,由 W3C XML 1.0 建议的 2.3 通用语法构造 部分定义。
当此属性设置为 true默认设置时, XmlException 如果 XML 文件包含非法字符或无效的 XML 名称(例如,元素名称以数字开头),则会引发异常。
XmlReader如果正在处理文本数据,则无论属性设置如何,它始终检查 XML 名称和文本内容是否有效。 将CheckCharacters设置为false可关闭字符实体引用的字符检查。