XmlValidatingReader.ReadString 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将元素或文本节点的内容作为字符串读取。
public:
override System::String ^ ReadString();
public override string ReadString();
override this.ReadString : unit -> string
Public Overrides Function ReadString () As String
返回
元素或文本节点的内容。 如果读取器位于除元素或文本节点以外的内容上,或者当前上下文中没有要返回的文本内容,则可以为空字符串。
注解
文本节点可以是元素或属性文本节点。
注释
该 XmlValidatingReader 类在 .NET Framework 2.0 中已过时。 可以使用类和Create方法创建验证XmlReader实例XmlReaderSettings。 有关详细信息,请参阅 XmlReader 引用页的“备注”部分。
如果定位在元素上, ReadString 则将所有文本、重大空白、空格和 CDATA 节节点类型连接在一起,并将串联的数据作为元素内容返回。 遇到任何标记(包括注释和处理指令)时,读取器将停止。 这可能发生在混合内容模型中,或者在读取元素结束标记时发生。
如果定位在文本节点上, ReadString 则从文本节点到元素结束标记执行相同的串联。 如果读取器位于属性文本节点上, ReadString 则具有与读取器位于元素开始标记上的位置相同的功能。 它返回所有串联的元素文本节点。
该 EntityHandling 属性确定工作原理 ReadString ,如下所示:
| 价值 | 说明 |
|---|---|
| ExpandEntities | 返回展开的字符和常规实体。 这是默认值。 |
| ExpandCharEntities | 返回文本内容,但不包括常规实体引用。 这意味着常规实体会导致 ReadString 停止。 必须调用 Read 以单步执行实体引用。 |