XmlTextReader.EntityHandling 属性

定义

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

获取或设置一个值，该值指定读取器处理实体的方式。

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.ExpandCharEntities。

备注

从 .NET Framework 2.0 开始，我们建议使用该方法XmlReader.Create利用新功能来创建XmlReader实例。

此属性可以动态更改，并在下一次 Read 调用后生效。

ExpandCharEntities设置为时EntityHandling，属性值仅部分规范化。读取器独立于相邻实体引用节点的内容规范化每个单独的文本节点。

为了说明实体处理模式之间的差异，请考虑以下 XML：

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

当 EntityHandling 设置为 ExpandEntities “doc”元素节点时，包含一个包含扩展实体文本的文本节点：

深度	节点类型	名称	值
1	`Text`		A 123

当 EntityHandling 设置为 ExpandCharEntities或 WhitespaceHandling 设置为 Significant 或 All设置为“doc”元素时，将展开字符实体，并将常规实体作为节点返回：