通过

XmlReader.ReadElementContentAsString 方法

定义

命名空间:
System.Xml
程序集:
System.Xml.dll, System.Xml.ReaderWriter.dll
程序集:
netstandard.dll, System.Xml.ReaderWriter.dll
程序集:
System.Xml.ReaderWriter.dll
程序集:
System.Xml.dll
程序集:
netstandard.dll

读取当前元素，并将内容作为对象 String 返回。

重载

名称 说明
ReadElementContentAsString(String, String)

检查指定的本地名称和命名空间 URI 是否与当前元素的本地名称和命名空间 URI 匹配，然后读取当前元素并将内容作为 String 对象返回。
ReadElementContentAsString()

读取当前元素，并将内容作为对象 String 返回。

ReadElementContentAsString(String, String)

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

检查指定的本地名称和命名空间 URI 是否与当前元素的本地名称和命名空间 URI 匹配，然后读取当前元素并将内容作为 String 对象返回。

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);
public virtual string ReadElementContentAsString(string localName, string namespaceURI);
abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string
Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

参数

localName
String

元素的本地名称。

namespaceURI
String

元素的命名空间 URI。

返回

String

元素内容作为 String 对象。

例外

InvalidOperationException

该 XmlReader 元素不定位在元素上。

-或-

在上一个异步操作完成之前调用了一个 XmlReader 方法。 在这种情况下， InvalidOperationException 会引发消息“正在进行异步操作”。

XmlException

当前元素包含子元素。

-或-

元素内容无法转换为 String 对象。

ArgumentNullException

使用参数调用 null 该方法。

ArgumentException

指定的本地名称和命名空间 URI 与正在读取的当前元素的 URI 不匹配。

示例

下面的示例读取 stringValue 元素并返回文本内容（忽略注释和处理指令）。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

该示例使用 dataFile.xml 该文件作为输入。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注解

此方法读取开始标记、元素的内容，并将读取器移到结束元素标记之后。 它扩展实体并忽略处理指令和注释。 元素只能包含简单内容。 也就是说，它不能有子元素。

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

适用于

ReadElementContentAsString()

Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs
Source:
XmlReader.cs

读取当前元素，并将内容作为对象 String 返回。

public:
 virtual System::String ^ ReadElementContentAsString();
public virtual string ReadElementContentAsString();
abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string
Public Overridable Function ReadElementContentAsString () As String

返回

String

元素内容作为 String 对象。

例外

InvalidOperationException

该 XmlReader 元素不定位在元素上。

-或-

在上一个异步操作完成之前调用了一个 XmlReader 方法。 在这种情况下， InvalidOperationException 会引发消息“正在进行异步操作”。

XmlException

当前元素包含子元素。

-或-

元素内容无法转换为 String 对象。

ArgumentNullException

使用参数调用 null 该方法。

示例

下面的示例读取 stringValue 元素并返回文本内容（忽略注释和处理指令）。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

该示例使用 dataFile.xml 该文件作为输入。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注解

此方法读取开始标记、元素的内容，并将读取器移到结束元素标记之后。 它扩展实体并忽略处理指令和注释。 元素只能包含简单内容。 也就是说，它不能有子元素。

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

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

适用于