XmlReader.ReadContentAsString 方法

定义

重要

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

将当前位置的文本内容作为对象 String 读取。

public:
 virtual System::String ^ ReadContentAsString();

public virtual string ReadContentAsString();

abstract member ReadContentAsString : unit -> string
override this.ReadContentAsString : unit -> string

Public Overridable Function ReadContentAsString () As String

String

作为对象的文本内容 String 。

尝试的强制转换无效。

字符串格式无效。

在上一个异步操作完成之前调用了一个 XmlReader 方法。在这种情况下， InvalidOperationException 会引发消息“正在进行异步操作”。

此方法连接文本、空白、重要空格和 CDATA 部分，并跳过任何注释或处理指令。会自动解析实体引用。

此方法可用于将类型化值转换为字符串，或在跳过注释和处理指令时读取文本内容。

下表介绍了此方法如何处理每个节点类型。

XmlNodeType	返回值	读取者行为
`Text` `CDATA` `Whitespace` `SignificantWhitespace` `EntityReference` `EndEntity`	文本、CDATA、空格和重要空白节点的串联内容转换为请求的类型。	移动到下一个起始元素或结束元素标记。会自动扩展实体引用。
`Attribute`	与调用 `XmlConvert.ToXxx` 属性值相同。	读取器将保留在当前位置。
`Comment` `ProcessingInstruction`	忽略处理指令（PI）或注释，并读取 PI 或注释后面的串联文本内容。	移动到下一个起始元素或结束元素标记。会自动扩展实体引用。
`EndElement`	空字符串。	读取器将保留在当前位置。
`Element` `XmlDeclaration` `None` `Document` `DocumentType` `Notation` `Entity` `DocumentFragment`	将引发 An InvalidOperationException 。	未定义，尽管读取器通常保留在当前位置。

有关详细信息，请参阅参考页的 XmlReader “备注”部分和 W3C XML 架构第 2 部分：数据类型建议。

有关此方法的异步版本，请参阅 ReadContentAsStringAsync。

此页面是否有帮助？