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

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

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

XmlReader.ReadElementContentAsDateTime メソッド ()

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

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

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAsDateTime As DateTime

Visual Basic (使用法)

Dim instance As XmlReader
Dim returnValue As DateTime

returnValue = instance.ReadElementContentAsDateTime

public virtual DateTime ReadElementContentAsDateTime ()

C++

public:
virtual DateTime ReadElementContentAsDateTime ()

public DateTime ReadElementContentAsDateTime ()

JScript

public function ReadElementContentAsDateTime
 () : DateTime

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

例外

例外の種類

条件

InvalidOperationException

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

XmlException

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

または

要素の内容を DateTime オブジェクトに変換できません。

ArgumentNullException

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

解説

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

内容が型指定された 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 に設定します。

詳細については、「型指定されたデータの読み取り」を参照してください。

使用例

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

Visual Basic

Using reader As XmlReader = XmlReader.Create("dataFile.xml")
  reader.ReadToFollowing("date")
  Dim [date] As DateTime = reader.ReadElementContentAsDateTime()
            
  ' 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 = reader.ReadElementContentAsDateTime();
  
     // 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.ReadElementContentAsDateTime メソッド (String, String)

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

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

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

Visual Basic (宣言)

Public Overridable Function
 ReadElementContentAsDateTime ( _
    localName As String, _
    namespaceURI As String _
) As DateTime

Visual Basic (使用法)

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

returnValue = instance.ReadElementContentAsDateTime(localName, namespaceURI)

public virtual DateTime ReadElementContentAsDateTime (
    string localName,
    string namespaceURI
)

C++

public:
virtual DateTime ReadElementContentAsDateTime (
    String^ localName, 
    String^ namespaceURI
)

public DateTime ReadElementContentAsDateTime (
    String localName, 
    String namespaceURI
)

JScript

public function ReadElementContentAsDateTime
 (
    localName : String, 
    namespaceURI : String
) : DateTime

パラメータ

localName: 要素のローカル名。

namespaceURI: 要素の名前空間 URI。

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

例外

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

解説

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

詳細については、「型指定されたデータの読み取り」を参照してください。

プラットフォーム

バージョン情報

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

参照

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

XmlReader.ReadElementContentAsDateTime メソッド

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

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