XmlReader.ReadStartElement 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

檢查以確定目前節點為項目，然後使讀取器前進至下一個節點。

多載

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()