XmlReader.ReadElementString 方法

定义

命名空间:

System.Xml

程序集:

netstandard.dll, System.Xml.ReaderWriter.dll

读取简单的纯文本元素。 但是，我们建议改用 ReadElementContentAsString 该方法，因为它提供了一种更直接的方法来处理此操作。

重载

名称	说明
ReadElementString()	读取纯文本元素。 但是，我们建议改用 ReadElementContentAsString() 该方法，因为它提供了一种更直接的方法来处理此操作。
ReadElementString(String)	在读取纯文本元素之前，检查找到的元素的属性是否 Name 与给定字符串匹配。 但是，我们建议改用 ReadElementContentAsString() 该方法，因为它提供了一种更直接的方法来处理此操作。
ReadElementString(String, String)	在读取纯文本元素之前，检查找到的元素和LocalName属性是否NamespaceURI与给定字符串匹配。 但是，我们建议改用 ReadElementContentAsString(String, String) 该方法，因为它提供了一种更直接的方法来处理此操作。

注解

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

ReadElementString()

Source:

XmlReader.cs

读取纯文本元素。 但是，我们建议改用 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)

Source:

XmlReader.cs

在读取纯文本元素之前，检查找到的元素的属性是否 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)

Source:

XmlReader.cs

在读取纯文本元素之前，检查找到的元素和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) 该方法读取文本元素。