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 数据中的字符，如果任何字符不在法定 XML 字符范围内，则引发 XmlException 该字符。 如果启用字符检查，必须确保符合下列条件：

• 字符在法定 XML 字符范围内，由 W3C XML 1.0 建议的 2.2 个字符 部分定义。

• 所有 XML 名称都是有效的，由 W3C XML 1.0 建议的 2.3 通用语法构造 部分定义。

当此属性设置为 true默认设置时， XmlException 如果 XML 文件包含非法字符或无效的 XML 名称（例如，元素名称以数字 () 开头），则会引发异常。

如果 XmlReader 处理文本数据，则无论属性如何设置，读取器将总是检查 XML 名称和文本内容是否有效。 将 CheckCharacters 设置为 false 会禁用对字符实体引用的字符检查。