XmlReader.ReadElementContentAsDateTime メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。
オーバーロード
ReadElementContentAsDateTime() |
現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。 |
ReadElementContentAsDateTime(String, String) |
指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを DateTime オブジェクトとして返します。 |
ReadElementContentAsDateTime()
現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。
public:
virtual DateTime ReadElementContentAsDateTime();
public virtual DateTime ReadElementContentAsDateTime ();
abstract member ReadElementContentAsDateTime : unit -> DateTime
override this.ReadElementContentAsDateTime : unit -> DateTime
Public Overridable Function ReadElementContentAsDateTime () As DateTime
戻り値
コンテンツの要素、DateTimeオブジェクト。
例外
XmlReader が要素に配置されません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
引数に null
を渡してメソッドが呼び出されました。
例
次の例では、メソッドを ReadElementContentAsDateTime 使用して要素の内容を date
読み取います。
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());
}
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
この例は、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>
注釈
このメソッドは、開始タグ、要素の内容を読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には、単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。
コンテンツが入力された xsd:dateTime
場合、リーダーはボックス DateTime 化されていないオブジェクトを返します。 コンテンツが入力xsd:dateTime
されていない場合、リーダーは W3C XML スキーマ パート 2: データ型に関するDateTime推奨事項で定義されている規則に従って、オブジェクトへの変換を試みます。
注意
内容が DateTime.Year として型指定されている場合は、xsd:gMonthDay
値は信頼できません。 XmlReader この場合、値は DateTime.Year 常に 1904 に設定されます。
詳細については、XmlReader のリファレンス ページの「解説」を参照してください。
適用対象
ReadElementContentAsDateTime(String, String)
指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを DateTime オブジェクトとして返します。
public:
virtual DateTime ReadElementContentAsDateTime(System::String ^ localName, System::String ^ namespaceURI);
public virtual DateTime ReadElementContentAsDateTime (string localName, string namespaceURI);
abstract member ReadElementContentAsDateTime : string * string -> DateTime
override this.ReadElementContentAsDateTime : string * string -> DateTime
Public Overridable Function ReadElementContentAsDateTime (localName As String, namespaceURI As String) As DateTime
パラメーター
- localName
- String
要素のローカル名。
- namespaceURI
- String
要素の名前空間 URI。
戻り値
DateTime オブジェクトとしての要素のコンテンツ。
例外
XmlReader が要素に配置されません。
- または -
先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。 この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。
引数に null
を渡してメソッドが呼び出されました。
指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。
注釈
このメソッドは、開始タグ、要素の内容を読み取り、リーダーを終了要素タグの後に移動します。 エンティティを展開し、処理命令とコメントを無視します。 要素には、単純なコンテンツのみを含めることができます。 つまり、子要素を持つことはできません。
コンテンツが入力された xsd:dateTime
場合、リーダーはボックス DateTime 化されていないオブジェクトを返します。 コンテンツが入力xsd:dateTime
されていない場合、リーダーは W3C XML スキーマ パート 2: データ型に関するDateTime推奨事項で定義されている規則に従って、オブジェクトへの変換を試みます。
注意
内容が DateTime.Year として型指定されている場合は、xsd:gMonthDay
値は信頼できません。 XmlReader この場合、値は DateTime.Year 常に 1904 に設定されます。
詳細については、XmlReader のリファレンス ページの「解説」を参照してください。