XmlReader.ReadElementContentAs 方法

定義

命名空間:: System.Xml

組件:: System.Xml.dll, System.Xml.ReaderWriter.dll

組件:: netstandard.dll, System.Xml.ReaderWriter.dll

組件:: System.Xml.ReaderWriter.dll

組件:: System.Xml.dll

組件:: netstandard.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

讀取目前元素，並將內容以指定類型的物件回傳。

多載

名稱	Description
ReadElementContentAs(Type, IXmlNamespaceResolver)	讀取元素內容為請求的類型。
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後將元素內容讀取為請求的類型。

ReadElementContentAs(Type, IXmlNamespaceResolver)

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

讀取元素內容為請求的類型。

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver) As Object

參數

returnType: Type

要回傳的值類型。

註隨著 .NET Framework 3.5 的發布，參數的值 returnType 現在可以是 DateTimeOffset 型別。

namespaceResolver: IXmlNamespaceResolver

一個 IXmlNamespaceResolver 用於解析與型別轉換相關的命名空間前綴的物件。

傳回

Object

元素內容會轉換成所請求的類型物件。

例外狀況

InvalidOperationException

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

-或-

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

XmlException

目前元素包含子元素。

-或-

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

ArgumentNullException

此方法以參數呼叫 null 。

OverflowException

閱讀 Decimal.MaxValue。

範例

以下範例使用該 ReadElementContentAs 方法來讀取節點內容 date 。

using (XmlReader reader = XmlReader.Create("dataFile.xml")) {
     reader.ReadToFollowing("date");
     DateTime date = (DateTime) reader.ReadElementContentAs(typeof(System.DateTime), null);
  
     // 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 = CType(reader.ReadElementContentAs(GetType(System.DateTime), Nothing), DateTime)
            
  ' 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>

備註

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

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

關於此方法的非同步版本，請參見 ReadElementContentAsAsync。

適用於

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

來源:: XmlReader.cs

檢查指定的本地名稱與命名空間 URI 是否與當前元素相符，然後將元素內容讀取為請求的類型。

public:
 virtual System::Object ^ ReadElementContentAs(Type ^ returnType, System::Xml::IXmlNamespaceResolver ^ namespaceResolver, System::String ^ localName, System::String ^ namespaceURI);

public virtual object ReadElementContentAs(Type returnType, System.Xml.IXmlNamespaceResolver namespaceResolver, string localName, string namespaceURI);

abstract member ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj
override this.ReadElementContentAs : Type * System.Xml.IXmlNamespaceResolver * string * string -> obj

Public Overridable Function ReadElementContentAs (returnType As Type, namespaceResolver As IXmlNamespaceResolver, localName As String, namespaceURI As String) As Object