XmlReader.ReadStartElement 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

檢查當前節點是否為元素，並將讀取器推進至下一個節點。

多載

名稱	Description
ReadStartElement()	檢查當前節點是否為元素，並將讀取器推進至下一個節點。
ReadStartElement(String)	檢查當前內容節點是否為與給定 Name 元素的元素，並將讀取器推進至下一個節點。
ReadStartElement(String, String)	檢查當前內容節點是否為元素，且為給定 LocalName ， NamespaceURI 並將讀取器推進至下一個節點。

ReadStartElement()

來源:

XmlReader.cs

檢查當前節點是否為元素，並將讀取器推進至下一個節點。

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)

來源:

XmlReader.cs

檢查當前內容節點是否為與給定 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)

來源:

XmlReader.cs

檢查當前內容節點是否為元素，且為給定 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()