XmlReader.ReadElementContentAsとは何？わかりやすく解説 Weblio辞書

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

索引トップ用語の索引ランキング

XmlReader.ReadElementContentAs メソッド (Type, IXmlNamespaceResolver)

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

要素の内容を要求された型として返します。

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAs ( _
    returnType As Type, _
    namespaceResolver As IXmlNamespaceResolver _
) As Object

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnType As Type
Dim namespaceResolver As IXmlNamespaceResolver
Dim returnValue As Object

returnValue = instance.ReadElementContentAs(returnType, namespaceResolver)

public virtual Object ReadElementContentAs (
    Type returnType,
    IXmlNamespaceResolver namespaceResolver
)

C++

public:
virtual Object^ ReadElementContentAs (
    Type^ returnType, 
    IXmlNamespaceResolver^ namespaceResolver
)

public Object ReadElementContentAs (
    Type returnType, 
    IXmlNamespaceResolver namespaceResolver
)

JScript

public function ReadElementContentAs (
    returnType : Type, 
    namespaceResolver : IXmlNamespaceResolver
) : Object

パラメータ

returnType: 返される値の型。

namespaceResolver: 型変換に関連する名前空間プリフィックスの解決に使用される IXmlNamespaceResolver オブジェクト。

戻り値
要求された型のオブジェクトに変換された要素の内容。

例外

例外の種類

条件

InvalidOperationException

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

XmlException

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

または

要素の内容を要求された型に変換できません。

ArgumentNullException

引数に null 参照 (Visual Basic では Nothing) を渡してメソッドが呼び出されました。

解説

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

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

使用例

ReadElementContentAs メソッドを使用して date ノードの内容を読み取る例を次に示します。

Visual Basic

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = CType(reader.ReadElementContentAs(GetType(System.DateTime),
 Nothing), DateTime)
            
  ' If the current culture is "en-US",
  ' this writes "Wednesday, January 8, 2003".
  Console.WriteLine([date].ToLongDateString())
End Using

using (XmlReader reader = XmlReader.Create("dataFile.xml"))
 {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime),
 null);
  
     // If the current culture is "en-US",
     // this writes "Wednesday, January 8, 2003".
     Console.WriteLine(date.ToLongDateString());    
}

この例では、入力として、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.ReadElementContentAs メソッド (Type, IXmlNamespaceResolver, String, String)