XmlReader.ReadContentAsDateTime 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReader.cs

以物件形式讀取當前位置 DateTime 的文字內容。

public:
 virtual DateTime ReadContentAsDateTime();

public virtual DateTime ReadContentAsDateTime();

abstract member ReadContentAsDateTime : unit -> DateTime
override this.ReadContentAsDateTime : unit -> DateTime

Public Overridable Function ReadContentAsDateTime () As DateTime

傳回

DateTime

文字內容作為 DateTime 物件。

例外狀況

InvalidCastException

嘗試的演員陣容並不有效。

FormatException

字串格式不適用。

InvalidOperationException

在先前非同步操作結束前，會呼叫一個 XmlReader 方法。 此時， InvalidOperationException 會拋出「非同步操作已進行中」的訊息。

備註

此方法串接文字、空白空間、顯著空白與 CDATA 區段，並跳過任何註解或處理指令。 實體參考會自動解決。

若內容被輸入 xsd:dateTime為 ，讀取器會回傳一個未 DateTime 開箱物件。 若內容未被輸入xsd:dateTime型別，讀取器將依照 W3C XML 架構第 2 部分：資料型別建議所定義的規則，嘗試將其轉換為物件DateTime。

Note

當內容類型為 DateTime.Year時，您無法依賴 xsd:gMonthDay 值。 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	未定義，但通常讀者仍停留在當前位置。

欲了解更多資訊，請參閱 XmlReader 參考頁面及 W3C XML 架構第二部分：資料型 別建議。