XmlReader.ReadElementContentAsDateTime 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

讀取目前元素，並將內容以 DateTime 物件形式回傳。

多載

名稱	Description
ReadElementContentAsDateTime()	讀取目前元素，並將內容以 DateTime 物件形式回傳。
ReadElementContentAsDateTime(String, String)	檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後讀取該當前元素並將內容作為 DateTime 物件回傳。

ReadElementContentAsDateTime()

來源:

XmlReader.cs

讀取目前元素，並將內容以 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

元素內容作為 DateTime 物件。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

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

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換成 DateTime 物件。

ArgumentNullException

此方法以參數呼叫 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。

Note

當內容類型為 DateTime.Year時，您無法依賴 xsd:gMonthDay 值。 XmlReader 此時 總是將值設 DateTime.Year 為 1904。

如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。

ReadElementContentAsDateTime(String, String)

來源:

XmlReader.cs

檢查指定的本地名稱與命名空間 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

該元素以物件形式內容 DateTime 。

例外狀況

InvalidOperationException

它 XmlReader 並未被定位在元素上。

-或-

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

XmlException

目前元素包含子元素。

-或-

元素內容無法轉換為所請求的類型。

ArgumentNullException

此方法以參數呼叫 null 。

ArgumentException

指定的本地名稱與命名空間 URI 與目前被讀取的元素不符。

備註

此方法讀取起始標籤、元素內容，並將讀取器移過終點元素標籤。 它會擴展實體，並忽略處理指令與註解。 該元素只能包含簡單內容。 也就是說，它不能有子元素。

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

Note

當內容類型為 DateTime.Year時，您無法依賴 xsd:gMonthDay 值。 XmlReader 此時 總是將值設 DateTime.Year 為 1904。

如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。