XmlReader.ReadContentAsDateTime メソッド

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

XmlReader.ReadContentAsDateTime メソッド

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

現在の位置でテキストの内容を DateTime オブジェクトとして読み取ります。

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

Visual Basic (宣言)

Public Overridable Function
 ReadContentAsDateTime As DateTime

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As DateTime

returnValue = instance.ReadContentAsDateTime

C#

public virtual DateTime ReadContentAsDateTime ()

C++

public:
virtual DateTime ReadContentAsDateTime ()

J#

public DateTime ReadContentAsDateTime ()

JScript

public function ReadContentAsDateTime () :
 DateTime

戻り値
DateTime オブジェクトとしてのテキストの内容。

例外

例外の種類	条件
InvalidCastException	試行されたキャストが無効です。
FormatException	文字列書式が無効です。

解説

このメソッドは、テキスト、空白、有意の空白、および CDATA セクションを連結し、すべてのコメントまたは処理命令をスキップします。エンティティ参照は自動的に解決されます。

内容が型指定された xsd:dateTime の場合、リーダーは、ボックス化が解除された DateTime オブジェクトを返します。内容が型指定されていない xsd:dateTime の場合、リーダーは、W3C 勧告『XML Schema Part 2: Datatypes』(http://www.w3.org/TR/xmlschema-2/) によって定義された規則に従って DateTime オブジェクトに変換しようとします。

メモ
内容が xsd:gMonthDay として型指定されている場合は、DateTime.Year 値を使用しないでください。この場合、XmlReader は DateTime.Year 値を常に 1904 に設定します。

このメソッドで各ノード型がどのように処理されるかについて、次の表に示します。

XmlNodeType	戻り値	リーダーの動作
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	連結されたテキストの内容、CDATA、空白、および要求された型に変換された有意な空白ノード。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
Attribute	属性値による XmlConvert.ToXxx の呼び出しと同じ。	リーダーは、現在の位置から変わりません。
Comment ProcessingInstruction	処理命令 (PI) またはコメントを無視し、PI またはコメントに続く、連結されたテキストの内容を読み込みます。	次の開始要素タグまたは終了要素タグに移動します。エンティティ参照は自動的に展開されます。
EndElement	空の文字列。	リーダーは、現在の位置から変わりません。
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	InvalidOperationException がスローされます。	未定義。ただし、リーダー (読み取り機能) は現在の位置にとどまるのが一般的です。

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

プラットフォーム

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 名前空間
その他の技術情報
型指定されたデータの読み取り