XmlReader.ReadElementContentAs 方法

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

以指定型別之物件的形式，讀取目前的項目並傳回內容。

多載

ReadElementContentAs(Type, IXmlNamespaceResolver)	以要求之型別的形式讀取項目內容。
ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)	檢查指定的區域名稱和命名空間 URI 是否與目前的項目相符，然後以要求之型別的形式讀取項目內容。

ReadElementContentAs(Type, IXmlNamespaceResolver)

來源:

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 架構第 2 部分：資料類型 建議。

如需這個方法的非同步版本，請參閱 ReadElementContentAsAsync 。

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

來源:

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

參數

returnType

Type

要傳回的值型别。

注意：使用 .NET Framework 3.5 的版本時，returnType 參數的值現在可以是 DateTimeOffset 類型。

namespaceResolver

IXmlNamespaceResolver

IXmlNamespaceResolver 物件，用來解析任何與型別轉換相關的命名空間前置詞。

localName

String

項目的本機名稱。

namespaceURI

String

項目的命名空間 URI。

傳回

Object

轉換為要求之類型物件的項目內容。

例外狀況

InvalidOperationException

XmlReader 並不是放置在項目上。

-或-

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

XmlException

目前的項目包含子項目。

-或-

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

ArgumentNullException

方法是以 null 引數呼叫。

ArgumentException

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

OverflowException

讀取 Decimal.MaxValue。

備註

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

如需詳細資訊，請參閱參考頁面的 XmlReader 一節和 W3C XML 架構第 2 部分：資料類型 建議。