XmlReader.ReadElementContentAsString メソッド ()

.NET Framework クラス ライブラリ リファレンス

XmlReader.ReadElementContentAsString メソッド ()

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

現在の要素を読み込み、その内容を String オブジェクトとして返します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAsString As String

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As String

returnValue = instance.ReadElementContentAsString

C#

public virtual string ReadElementContentAsString
 ()

C++

public:
virtual String^ ReadElementContentAsString ()

J#

public String ReadElementContentAsString ()

JScript

public function ReadElementContentAsString
 () : String

戻り値
String オブジェクトとしての要素の内容。

例外

例外の種類	条件
InvalidOperationException	XmlReader が要素に配置されません。
XmlException	現在の要素には、子要素が含まれています。 または 要素の内容を String オブジェクトに変換できません。
ArgumentNullException	引数に null 参照 (Visual Basic では Nothing) を渡してメソッドが呼び出されました。

解説

このメソッドは、開始タグと要素の内容を順に読み取り、リーダーを終了要素タグの後に移動します。エンティティを展開し、処理命令およびコメントを無視します。この要素には、単純な内容だけを格納できます。つまり、子要素は格納できません。

詳細については、「型指定されたデータの読み取り」および W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) を参照してください。

使用例

stringValue 要素を読み込んでテキストの内容 (コメントと処理命令は無視) を返す例を次に示します。

Visual Basic

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

C#

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

この例では、入力として、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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り

XmlReader.ReadElementContentAsString メソッド (String, String)

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

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

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

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

Visual Basic (使用法)

Dim instance As XmlReader
Dim localName As String
Dim namespaceURI As String
Dim returnValue As String

returnValue = instance.ReadElementContentAsString(localName, namespaceURI)

C#

public virtual string ReadElementContentAsString
 (
    string localName,
    string namespaceURI
)

C++

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

J#

public String ReadElementContentAsString (
    String localName, 
    String namespaceURI
)

JScript

public function ReadElementContentAsString
 (
    localName : String, 
    namespaceURI : String
) : String

パラメータ

localName

要素のローカル名。

namespaceURI

要素の名前空間 URI。

戻り値
String オブジェクトとしての要素の内容。

例外

例外の種類	条件
InvalidOperationException	XmlReader が要素に配置されません。
XmlException	現在の要素には、子要素が含まれています。 または 要素の内容を String オブジェクトに変換できません。
ArgumentNullException	引数に null 参照 (Visual Basic では Nothing) を渡してメソッドが呼び出されました。
ArgumentException	指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。

解説

このメソッドは、開始タグと要素の内容を順に読み取り、リーダーを終了要素タグの後に移動します。エンティティを展開し、処理命令およびコメントを無視します。この要素には、単純な内容だけを格納できます。つまり、子要素は格納できません。

詳細については、「型指定されたデータの読み取り」および W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) を参照してください。

使用例

stringValue 要素を読み込んでテキストの内容 (コメントと処理命令は無視) を返す例を次に示します。

Visual Basic

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

C#

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

この例では、入力として、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>

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReader クラス
XmlReader メンバ
System.Xml 名前空間
その他の技術情報
XmlReader による XML の読み取り

XmlReader.ReadElementContentAsString メソッド

現在の要素を読み込み、その内容を String オブジェクトとして返します。
オーバーロードの一覧

名前	説明
XmlReader.ReadElementContentAsString ()	現在の要素を読み込み、その内容を String オブジェクトとして返します。 .NET Compact Framework によってサポートされています。
XmlReader.ReadElementContentAsString (String, String)	指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み込んで内容を String オブジェクトとして返します。 .NET Compact Framework によってサポートされています。

参照

関連項目

XmlReader クラス
XmlReader メンバ
System.Xml 名前空間

その他の技術情報

XmlReader による XML の読み取り