XmlValidatingReader.EntityHandling 屬性

定義

命名空間:

System.Xml

組件:

netstandard.dll, System.Xml.ReaderWriter.dll

來源:

XmlValidatingReader.cs

取得或設定一個值，指定讀取器如何處理實體。

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 價值。 若指定 NO EntityHandling ，則預設為 EntityHandling.ExpandEntities。

例外狀況

ArgumentOutOfRangeException

標示無效值。

備註

備註

這個 XmlValidatingReader 類別在 .NET Framework 2.0 中已經過時。 你可以透過使用XmlReaderSettings類別和Create方法來建立一個驗證實XmlReader例。 如需詳細資訊，請參閱 XmlReader 參考頁面的＜備註＞一節。

此特性可更改，並在下一次 Read 通話後生效。

當 EntityHandling 設為 ExpandCharEntities時，屬性值僅部分正規化。 讀取器會獨立於相鄰實體參考節點的內容，對每個個別的文字節點進行正規化。

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

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

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

深度	節點類型	名稱	價值
1	文字		A 123

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

深度	節點類型	名稱	價值
1	文字		A
1	EntityReference	數字
1	重要空白

另請參閱

• XmlReader