XmlReader.ReadElementContentAsString メソッド

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。

オーバーロード

ReadElementContentAsString(String, String)	指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。
ReadElementContentAsString()	現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。

ReadElementContentAsString(String, String)

ソース:

XmlReader.cs

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを String オブジェクトとして返します。

public:
 virtual System::String ^ ReadElementContentAsString(System::String ^ localName, System::String ^ namespaceURI);

public virtual string ReadElementContentAsString (string localName, string namespaceURI);

abstract member ReadElementContentAsString : string * string -> string
override this.ReadElementContentAsString : string * string -> string

Public Overridable Function ReadElementContentAsString (localName As String, namespaceURI As String) As String

パラメーター

localName

String

要素のローカル名。

namespaceURI

String

要素の名前空間 URI。

戻り値

String

コンテンツの要素、Stringオブジェクト。

例外

InvalidOperationException

XmlReader が要素に配置されません。

- または -

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

XmlException

現在の要素には、子要素が含まれています。

- または -

要素のコンテンツを String オブジェクトに変換できません。

ArgumentNullException

引数に null を渡してメソッドが呼び出されました。

ArgumentException

指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。

例

次の例では、 要素を stringValue 読み取り、テキスト コンテンツを返します (コメントと処理命令は無視します)。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""));
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString("stringValue", ""))
End Using

この例は、dataFile.xml ファイルを入力として使用します。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注釈

このメソッドは、要素の内容である開始タグを読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。

詳細については、リファレンス ページの XmlReader 「解説」セクションと W3C XML スキーマ パート 2: データ型に関する推奨事項を 参照してください。

ReadElementContentAsString()

ソース:

XmlReader.cs

現在の要素を読み取り、そのコンテンツを String オブジェクトとして返します。

public:
 virtual System::String ^ ReadElementContentAsString();

public virtual string ReadElementContentAsString ();

abstract member ReadElementContentAsString : unit -> string
override this.ReadElementContentAsString : unit -> string

Public Overridable Function ReadElementContentAsString () As String

戻り値

String

コンテンツの要素、Stringオブジェクト。

例外

InvalidOperationException

XmlReader が要素に配置されません。

- または -

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

XmlException

現在の要素には、子要素が含まれています。

- または -

要素のコンテンツを String オブジェクトに変換できません。

ArgumentNullException

引数に null を渡してメソッドが呼び出されました。

例

次の例では、 要素を stringValue 読み取り、テキスト コンテンツを返します (コメントと処理命令は無視します)。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("stringValue");
     Console.WriteLine(reader.ReadElementContentAsString());			
}

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("stringValue")
  Console.WriteLine(reader.ReadElementContentAsString())
End Using

この例は、dataFile.xml ファイルを入力として使用します。

<root>
  <stringValue>
     <!--comment-->
     <?some pi?>
      text value of the element.
  </stringValue>
  <longValue>270000000000001</longValue>
  <number>0</number>
  <double>2E10</double>
  <date>2003-01-08T15:00:00-00:00</date>
</root>

注釈

このメソッドは、要素の内容である開始タグを読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。

詳細については、リファレンス ページの XmlReader 「解説」セクションと W3C XML スキーマ パート 2: データ型に関する推奨事項を 参照してください。

このメソッドの非同期バージョンについては、「」を参照してください ReadElementContentAsStringAsync。