XmlReader.ReadElementString 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.dll

程序集:

netstandard.dll

读取只有简单文本的元素。 但是，建议改用 ReadElementContentAsString 方法，因为该方法可以更直接地处理此操作。

重载

ReadElementString()	读取纯文本元素。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。
ReadElementString(String)	在读取纯文本元素之前，检查所找到元素的 Name 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。
ReadElementString(String, String)	在读取纯文本元素之前，检查所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString(String, String) 方法，因为该方法可以更直接地处理此操作。

注解

建议使用 ReadElementContentAsString 该方法读取文本元素。

ReadElementString()

读取纯文本元素。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。

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

public virtual string ReadElementString ();

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

Public Overridable Function ReadElementString () As String

返回

String

所读取的元素中包含的文本。 如果元素为空，则返回一个空字符串。

例外

XmlException

下一个内容节点不是开始标记；或者找到的元素不包含简单文本值。

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

建议使用 ReadElementContentAsString() 该方法读取文本元素。

ReadElementString(String)

在读取纯文本元素之前，检查所找到元素的 Name 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString() 方法，因为该方法可以更直接地处理此操作。

public:
 virtual System::String ^ ReadElementString(System::String ^ name);

public virtual string ReadElementString (string name);

abstract member ReadElementString : string -> string
override this.ReadElementString : string -> string

Public Overridable Function ReadElementString (name As String) As String

参数

name

String

要检查的名称。

返回

String

所读取的元素中包含的文本。 如果元素为空，则返回一个空字符串。

例外

XmlException

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

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

建议使用 ReadElementContentAsString() 该方法读取文本元素。

ReadElementString(String, String)

在读取纯文本元素之前，检查所找到元素的 LocalName 和 NamespaceURI 属性是否与给定的字符串匹配。 但是，建议改用 ReadElementContentAsString(String, String) 方法，因为该方法可以更直接地处理此操作。

public:
 virtual System::String ^ ReadElementString(System::String ^ localname, System::String ^ ns);

public virtual string ReadElementString (string localname, string ns);

abstract member ReadElementString : string * string -> string
override this.ReadElementString : string * string -> string

Public Overridable Function ReadElementString (localname As String, ns As String) As String

参数

localname

String

要检查的本地名称。

ns

String

要检查的命名空间 URI。

返回

String

所读取的元素中包含的文本。 如果元素为空，则返回一个空字符串。

例外

XmlException

如果下一个内容节点不是一个开始标记；如果元素 LocalName 或 NamespaceURI 与给定的参数不匹配；或者如果找到的元素不包含简单的文本值。

InvalidOperationException

在上一次异步操作完成之前调用了 XmlReader 方法。 在此情况下，会引发 InvalidOperationException 并显示消息“异步操作已在进行中。”

注解

建议使用 ReadElementContentAsString(String, String) 该方法读取文本元素。