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、リーダーがするように変換しようとした場合、DateTimeオブジェクトによって定義されたルールに従って、 W3C XML Schema Part 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に 1,904年にここで値します。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、リーダーがするように変換しようとした場合、DateTimeオブジェクトによって定義されたルールに従って、 W3C XML Schema Part 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に 1,904年にここで値します。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.

適用対象