XmlReader.ReadContentAsString 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

将当前位置的文本内容作为 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 对象的文本内容。

例外

InvalidCastException

试图进行的强制转换无效。

FormatException

该字符串格式无效。

InvalidOperationException

在上一次异步操作完成之前调用了 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	引发 InvalidOperationException。	未定义，尽管通常读取器将保留在当前位置。

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

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