共用方式為


XmlReader.ReadElementContentAs 方法

定義

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

多載

ReadElementContentAs(Type, IXmlNamespaceResolver)

以要求之型別的形式讀取項目內容。

ReadElementContentAs(Type, IXmlNamespaceResolver, String, String)

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

ReadElementContentAs(Type, IXmlNamespaceResolver)

來源:
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 物件,用來解析任何與型別轉換相關的命名空間前置詞。

傳回

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

例外狀況

XmlReader 並不是放置在項目上。

-或-

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

目前的項目包含子項目。

-或-

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

方法是以 null 引數呼叫。

讀取 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
來源:
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

參數

returnType
Type

要傳回的值型别。

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

namespaceResolver
IXmlNamespaceResolver

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

localName
String

項目的本機名稱。

namespaceURI
String

項目的命名空間 URI。

傳回

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

例外狀況

XmlReader 並不是放置在項目上。

-或-

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

目前的項目包含子項目。

-或-

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

方法是以 null 引數呼叫。

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

讀取 Decimal.MaxValue

備註

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

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

適用於