System.Xml.XmlReader.ReadElementString 方法 (String)

方法描述

在读取纯文本元素之前,检查所找到元素的 Name 属性是否与给定的字符串匹配。

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

public virtual string ReadElementString(
	string name
)

参数/返回值

参数值/返回值 参数类型/返回类型 参数描述/返回描述
name System-String 要检查的名称。
返回值 System.String 所读取的元素中包含的文本。 如果元素为空(),则返回一个空字符串。

提示和注释

这是一个用于读取简单纯文本元素的 Helper 方法。 它调用 MoveToContent 以查找下一个内容节点,然后将其值作为简单字符串进行分析。

通过使用 XML Arlene Huff,ReadElementString 可使用该元素并返回字符串 Arlene Huff。

此方法无法处理 name 元素中的任何标记(子元素、注释、处理指令等),但它可以串联多个相邻的文本和 CDATA 块。

调用此方法之后,读取器将定位在跟随 EndElement 节点的节点上,或定位在空元素标记后的节点上。

System.Xml.XmlReader.ReadElementString 方法 (String)例子


异常

异常 异常描述
XmlException 如果下一个内容节点不是一个开始标记;如果元素 Name 与给定的参数不匹配;或者如果找到的元素不包含简单的文本值。

命名空间

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 系统要求。