共用方式為


XmlTextReader.EntityHandling 屬性

定義

取得或設定值,表示讀取器如何處理實體。

public:
 property System::Xml::EntityHandling EntityHandling { System::Xml::EntityHandling get(); void set(System::Xml::EntityHandling value); };
public System.Xml.EntityHandling EntityHandling { get; set; }
member this.EntityHandling : System.Xml.EntityHandling with get, set
Public Property EntityHandling As EntityHandling

屬性值

EntityHandling

其中一個 EntityHandling 值。 如果未指定 EntityHandling,則會預設為 EntityHandling.ExpandCharEntities

備註

注意

從 .NET Framework 2.0 開始,建議您使用 XmlReader.Create 方法來建立 XmlReader 實例,以利用新功能。

這個屬性可以即時變更,並在下一次 Read 呼叫之後生效。

當 設定為 ExpandCharEntitiesEntityHandling ,屬性值只會部分正規化。 讀取器會將每個個別文位元組點與相鄰實體參考節點的內容分開正規化。

為了說明實體處理模式之間的差異,請考慮下列 XML:

<!DOCTYPE doc [<!ENTITY num "123">]>  
    <doc> &#65; &num; </doc>  

EntityHandling 設定為 ExpandEntities 「doc」 元素節點時,包含一個具有展開實體文字的文位元組點:

深度 節點類型 名稱
1 Text A 123

當 設定為 ExpandCharEntities ,且 WhitespaceHandling 設定 Significant 為 或 AllEntityHandling ,「doc」 元素會展開字元實體,並將一般實體傳回為節點:

深度 節點類型 名稱
1 Text A
1 EntityReference num
1 SignificantWhitespace

適用於

另請參閱