XmlReader.ReadStartElement 方法

定义

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

检查当前节点是否为元素，并将读取器前进到下一个节点。

重载

名称 说明
ReadStartElement()

检查当前节点是否为元素，并将读取器前进到下一个节点。
ReadStartElement(String)

检查当前内容节点是否是具有给定 Name 元素的元素，并将读取器前进到下一个节点。
ReadStartElement(String, String)

检查当前内容节点是否是具有给定 LocalName 元素的元素，并将 NamespaceURI 读取器前进到下一个节点。

ReadStartElement()

检查当前节点是否为元素，并将读取器前进到下一个节点。

public:
 virtual void ReadStartElement();
public virtual void ReadStartElement();
abstract member ReadStartElement : unit -> unit
override this.ReadStartElement : unit -> unit
Public Overridable Sub ReadStartElement ()

例外

XmlException

输入流中遇到不正确的 XML。

InvalidOperationException

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

注解

此方法调用 IsStartElement 后跟 Read 定位在输入流中找到的元素的内容。

另请参阅

适用于

ReadStartElement(String)

检查当前内容节点是否是具有给定 Name 元素的元素，并将读取器前进到下一个节点。

public:
 virtual void ReadStartElement(System::String ^ name);
public virtual void ReadStartElement(string name);
abstract member ReadStartElement : string -> unit
override this.ReadStartElement : string -> unit
Public Overridable Sub ReadStartElement (name As String)

参数

name
String

元素的限定名称。

例外

XmlException

输入流中遇到不正确的 XML。

-或-

元素 Name 与给定 name的元素不匹配。

InvalidOperationException

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

示例

以下示例显示每个元素的文本内容。

using (XmlReader reader = XmlReader.Create("book3.xml")) {

  // Parse the XML document.  ReadString is used to
  // read the text content of the elements.
  reader.Read();
  reader.ReadStartElement("book");
  reader.ReadStartElement("title");
  Console.Write("The content of the title element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadStartElement("price");
  Console.Write("The content of the price element:  ");
  Console.WriteLine(reader.ReadString());
  reader.ReadEndElement();
  reader.ReadEndElement();
}

Using reader As XmlReader = XmlReader.Create("book3.xml")
  ' Parse the XML document.  ReadString is used to
  ' read the text content of the elements.
  reader.Read()
  reader.ReadStartElement("book")
  reader.ReadStartElement("title")
  Console.Write("The content of the title element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadStartElement("price")
  Console.Write("The content of the price element:  ")
  Console.WriteLine(reader.ReadString())
  reader.ReadEndElement()
  reader.ReadEndElement()
End Using

此示例使用 book3.xml 该文件。

<book>
  <title>Pride And Prejudice</title>
  <price>19.95</price>
</book>

注解

对此方法的调用对应于调用 IsStartElement 后跟调用的调用 Read。

另请参阅

适用于

ReadStartElement(String, String)

检查当前内容节点是否是具有给定 LocalName 元素的元素，并将 NamespaceURI 读取器前进到下一个节点。

public:
 virtual void ReadStartElement(System::String ^ localname, System::String ^ ns);
public virtual void ReadStartElement(string localname, string ns);
abstract member ReadStartElement : string * string -> unit
override this.ReadStartElement : string * string -> unit
Public Overridable Sub ReadStartElement (localname As String, ns As String)

参数

localname
String

元素的本地名称。

ns
String

元素的命名空间 URI。

例外

XmlException

输入流中遇到不正确的 XML。

-或-

LocalName找到的元素的属性NamespaceURI与给定参数不匹配。

InvalidOperationException

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

注解

对此方法的调用对应于调用 IsStartElement 后跟调用的调用 Read。

另请参阅

适用于