XmlReader.ReadStartElement 方法

定义

命名空间:

System.Xml

程序集:

System.Xml.ReaderWriter.dll

程序集:

System.Xml.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 将你置于输入流中找到的元素的内容上。

另请参阅

• ReadEndElement()

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。

另请参阅

• ReadEndElement()

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。

另请参阅

• ReadEndElement()