System.Xml.XmlReader.ReadOuterXml 方法

方法描述

当在派生类中被重写时,读取表示该节点和所有它的子级的内容(包括标记)。

语法定义(C# System.Xml.XmlReader.ReadOuterXml 方法 的用法)

public virtual string ReadOuterXml()

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
返回值 System.String 如果读取器定位在元素或特性节点上,此方法将返回当前节点及其所有子级的所有 XML 内容(包括标记);否则返回空字符串。

提示和注释

此方法类似于 ReadInnerXml,但它还返回开始标记和结束标记。

此方法以下面的方式处理元素和特性节点:

节点类型

调用前的位置

XML 片段

返回值

调用后的位置

Element

在 item1 开始标记上。

text1text2

text1

在 item2 开始标记上。

Attribute

在 attr1 特性节点上。

text

attr1="val1"

保留在 attr1 特性节点上。

如果读取器定位在叶节点上,则调用 ReadOuterXml 等效于调用 Read。 此方法返回 String.Empty(特性节点除外,那种情况下将返回特性标记)。

此方法检查 XML 的格式是否良好。 如果从 XmlValidatingReader 中调用 ReadOuterXml,则此方法还验证返回的内容。

由于是在 XmlNodeReader、XmlTextReader 和 XmlValidatingReader 类中实现的,ReadOuterXml 方法可以识别命名空间。 假定有以下 XML 文本 hello,如果读取器定位在 S:B 开始标记上,则 ReadOuterXml 返回 hello

System.Xml.XmlReader.ReadOuterXml 方法例子

本示例将 2books.xml 文件用作输入。



  
    The Handmaid's Tale
    19.95
  
  
    Pride And Prejudice
    24.95
  

异常

异常 异常描述
XmlException XML 的格式不良,或分析 XML 时出错。

命名空间

namespace: System.Xml

程序集: System.Xml(在 System.Xml.dll 中)

版本信息

.NET Framework 受以下版本支持:4、3.5、3.0、2.0、1.1、1.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1 受以下版本支持:

适用平台

Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。