XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime XmlReader.ReadElementContentAsDateTime Method

定義

現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。Reads the current element and returns the contents as a DateTime object.

オーバーロード

ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime()

現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。Reads the current element and returns the contents as a DateTime object.

ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを DateTime オブジェクトとして返します。Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a DateTime object.

ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime() ReadElementContentAsDateTime()

現在の要素を読み取り、そのコンテンツを DateTime オブジェクトとして返します。Reads the current element and returns the contents as a DateTime object.

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オブジェクト。The element content as a DateTime object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

- または --or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

- または --or- 要素のコンテンツを DateTime オブジェクトに変換できません。The element content cannot be converted to a DateTime object.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

次の例ではReadElementContentAsDateTime 、メソッドを使用して、 date要素の内容を読み取ります。The following example uses the ReadElementContentAsDateTime method to read the content of the date element.

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 ファイルを入力として使用します。The example uses the dataFile.xml file as input.

<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>

注釈

このメソッドは、開始タグと要素の内容を読み取り、リーダーを終了要素タグの後ろに移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティが展開され、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つことはできません。That is, it cannot have child elements.

コンテンツが型指定xsd:dateTimeされている場合、リーダーはボックス化解除されDateTimeたオブジェクトを返します。If the content is typed xsd:dateTime, the reader returns an unboxed DateTime object. コンテンツが型指定xsd:dateTimeされていない場合、リーダーは、 W3C <xref:System.DateTime> XML スキーマパート2で定義されている規則に従って、オブジェクトへの変換を試みます。データ型の推奨。If the content is not typed xsd:dateTime, the reader attempts to convert it to a DateTime object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

注意

内容が DateTime.Year として型指定されている場合は、xsd:gMonthDay 値は信頼できません。You cannot rely on the DateTime.Year value when the content is typed as xsd:gMonthDay. XmlReaderこの場合、 DateTime.Yearは常に値を1904に設定します。XmlReader always sets the DateTime.Year value to 1904 in this case.

詳細については、XmlReader のリファレンス ページの「解説」を参照してください。For more information, see the Remarks section of the XmlReader reference page.

ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String) ReadElementContentAsDateTime(String, String)

指定されたローカル名と名前空間 URI が現在の要素のものと一致することを確認し、現在の要素を読み取って、コンテンツを DateTime オブジェクトとして返します。Checks that the specified local name and namespace URI matches that of the current element, then reads the current element and returns the contents as a DateTime object.

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 String String String

要素のローカル名。The local name of the element.

namespaceURI
String String String String

要素の名前空間 URI。The namespace URI of the element.

戻り値

DateTime オブジェクトとしての要素のコンテンツ。The element contents as a DateTime object.

例外

XmlReader が要素に配置されません。The XmlReader is not positioned on an element.

または-or-

先行の非同期操作が完了する前に、XmlReader メソッドが呼び出されました。An XmlReader method was called before a previous asynchronous operation finished. この場合、「非同期操作が既に実行されています」というメッセージと共に InvalidOperationException がスローされます。In this case, InvalidOperationException is thrown with the message "An asynchronous operation is already in progress."

現在の要素には、子要素が含まれています。The current element contains child elements.

- または --or-

要素のコンテンツを要求された型に変換できません。The element content cannot be converted to the requested type.

引数に null を渡してメソッドが呼び出されました。The method is called with null arguments.

指定されたローカル名と名前空間 URI は、現在読み取り中の要素と一致しません。The specified local name and namespace URI do not match that of the current element being read.

注釈

このメソッドは、開始タグと要素の内容を読み取り、リーダーを終了要素タグの後ろに移動します。This method reads the start tag, the contents of the element, and moves the reader past the end element tag. エンティティが展開され、処理命令とコメントは無視されます。It expands entities and ignores processing instructions and comments. 要素には、単純なコンテンツのみを含めることができます。The element can only contain simple content. つまり、子要素を持つことはできません。That is, it cannot have child elements.

コンテンツが型指定xsd:dateTimeされている場合、リーダーはボックス化解除されDateTimeたオブジェクトを返します。If the content is typed xsd:dateTime, the reader returns an unboxed DateTime object. コンテンツが型指定xsd:dateTimeされていない場合、リーダーは、 W3C <xref:System.DateTime> XML スキーマパート2で定義されている規則に従って、オブジェクトへの変換を試みます。データ型の推奨。If the content is not typed xsd:dateTime, the reader attempts to convert it to a DateTime object according to the rules defined by the W3C XML Schema Part 2: Datatypes recommendation.

注意

内容が DateTime.Year として型指定されている場合は、xsd:gMonthDay 値は信頼できません。You cannot rely on the DateTime.Year value when the content is typed as xsd:gMonthDay. XmlReaderこの場合、 DateTime.Yearは常に値を1904に設定します。XmlReader always sets the DateTime.Year value to 1904 in this case.

詳細については、XmlReader のリファレンス ページの「解説」を参照してください。For more information, see the Remarks section of the XmlReader reference page.

適用対象