XmlTextReader.EntityHandling 屬性

定義

重要

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

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

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.ExpandCharEntities。

注意

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

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

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

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

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

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

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

當設定為 ExpandCharEntities ，且 WhitespaceHandling 設定 Significant 為或 All 時 EntityHandling ，「doc」元素會展開字元實體，並將一般實體傳回為節點：