XmlReader.ReadContentAsObject 方法

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlReader.cs

以 . 讀取當前位置 Object的文字內容。

public:
 virtual System::Object ^ ReadContentAsObject();

public virtual object ReadContentAsObject();

abstract member ReadContentAsObject : unit -> obj
override this.ReadContentAsObject : unit -> obj

Public Overridable Function ReadContentAsObject () As Object

傳回

Object

文字內容作為最合適的通用語言執行時（CLR）物件。

例外狀況

InvalidCastException

嘗試的演員陣容並不有效。

FormatException

字串格式不適用。

InvalidOperationException

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

備註

此方法串接文字、空白空間、顯著空白與 CDATA 區段，並跳過任何註解或處理指令。 實體參考會自動解決。

若內容被輸入，讀取器會回傳一個由屬性指定 ValueType 的最適當類型方框 CLR。 若內容為列表型別，讀取器會回傳一個相應型態的盒狀物件陣列。

備註

若解析內容時發生驗證錯誤，且讀取器是 XmlReader 方法所建立 Create 的物件，讀取器會以字串形式回傳內容。 換句話說，當出現驗證錯誤或警告時，該內容被視為未輸入。

若內容未被輸入，讀取器會以字串形式回傳內容。

下表說明此方法如何處理每種節點類型。

XmlNodeType	返回值	讀者行為
Text CDATA Whitespace SignificantWhitespace EntityReference EndEntity	串接內容的文字、CDATA、空白空間及重要空白節點轉換為所需類型。	移動到下一個起始元素或結束元素標籤。 實體參考會自動展開。
Attribute	就像呼叫 XmlConvert.ToXxx 屬性值一樣。	讀者仍停留在當前位置
Comment ProcessingInstruction	忽略處理指令（PI）或註解，閱讀緊接在 PI 或註解後的串接文字內容。	移動到下一個起始元素或結束元素標籤。 實體參考會自動展開。
EndElement	若讀取器為結構驗證讀取器（ValidationType 設為 Schema;否則為空字串）。	讀者仍停留在當前位置。
Element XmlDeclaration None Document DocumentType Notation Entity DocumentFragment	An InvalidOperationException 被拋出。	未定義，但通常讀者仍停留在當前位置。

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

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