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 がスローされます。

注釈

このメソッドは、その後に続くRead呼び出しを呼び出IsStartElementして、入力ストリームで見つかったその要素の内容に移動します。

こちらもご覧ください

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