XmlReader.ReadElementContentAsDateTime 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

以 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

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 轉換成 物件。

注意

當內容的型別為 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

DateTime 物件形式的項目內容。

例外狀況

InvalidOperationException

XmlReader 並不是放置在項目上。

-或-

在先前的非同步作業完成前呼叫了 XmlReader 方法。 在此情況下，會擲回 InvalidOperationException 與「非同步作業已經在進行中」的訊息。

XmlException

目前的項目包含子項目。

-或-

項目內容無法轉換成要求的類型。

ArgumentNullException

方法是以 null 引數呼叫。

ArgumentException

指定的區域名稱和命名空間 URI，與目前正在讀取的項目不相符。

備註

這個方法會讀取開始標籤、元素的內容，並將讀取器移至結束元素標籤的後面。 它會展開實體，並忽略處理指示和批註。 元素只能包含簡單內容。 也就是說，它不能有子項目。

如果內容類型為 xsd:dateTime ，讀取器會傳回未收件匣 DateTime 的物件。 如果未輸入 xsd:dateTime 內容，讀取器會根據W3C XML 架構第 2 部分：資料類型建議所定義的規則，嘗試將它 DateTime 轉換成 物件。

注意

當內容的型別為 DateTime.Year 時，無法依賴 xsd:gMonthDay 值。 XmlReader 在此情況下，一律會將 DateTime.Year 值設定為 1904。

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