英語で読む

次の方法で共有


XmlReader.ReadStartElement メソッド

定義

現在のノードが要素であるか調べ、リーダーを次のノードに進めます。

オーバーロード

ReadStartElement()

現在のノードが要素であるか調べ、リーダーを次のノードに進めます。

ReadStartElement(String)

現在のコンテンツ ノードが、指定した Name を持つ要素で、リーダーを次のノードに進めることを確認します。

ReadStartElement(String, String)

現在のコンテンツ ノードが、指定した LocalNameNamespaceURI を持つ要素で、リーダーを次のノードに進めることを確認します。

ReadStartElement()

現在のノードが要素であるか調べ、リーダーを次のノードに進めます。

C#
public virtual void ReadStartElement ();

例外

入力ストリームで、正しくない XML が検出されました。

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

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

こちらもご覧ください

適用対象

.NET 7 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ReadStartElement(String)

現在のコンテンツ ノードが、指定した Name を持つ要素で、リーダーを次のノードに進めることを確認します。

C#
public virtual void ReadStartElement (string name);

パラメーター

name
String

要素の限定名。

例外

入力ストリームで、正しくない XML が検出されました。

  • または -

要素の Name が指定した name と一致しません。

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

次の例では、各要素のテキストコンテンツを表示します。

C#
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();
}

この例では、ファイルを使用します book3.xml

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

注釈

このメソッドの呼び出しは、呼び出しの後に呼び出しが続く呼び出しに IsStartElement 対応します Read

こちらもご覧ください

適用対象

.NET 7 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0

ReadStartElement(String, String)

現在のコンテンツ ノードが、指定した LocalNameNamespaceURI を持つ要素で、リーダーを次のノードに進めることを確認します。

C#
public virtual void ReadStartElement (string localname, string ns);

パラメーター

localname
String

要素のローカル名。

ns
String

要素の名前空間 URI。

例外

入力ストリームで、正しくない XML が検出されました。

  • または -

見つかった要素の LocalName プロパティと NamespaceURI プロパティが指定した引数と一致しません。

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。

注釈

このメソッドの呼び出しは、呼び出しの後に呼び出しが続く呼び出しに IsStartElement 対応します Read

こちらもご覧ください

適用対象

.NET 7 およびその他のバージョン
製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1
UWP 10.0