XmlReaderSettings.CheckCharacters 屬性

定義

命名空間:

System.Xml

組件:

System.Xml.ReaderWriter.dll

來源:

XmlReaderSettings.cs

取得或設定值，綁表示是否要執行字元檢查。

public:
 property bool CheckCharacters { bool get(); void set(bool value); };

public bool CheckCharacters { get; set; }

member this.CheckCharacters : bool with get, set

Public Property CheckCharacters As Boolean

屬性值

Boolean

true 表示執行字元檢查，否則為 false。 預設為 true。

備註

這個屬性會指示 XML 讀取器檢查所讀取之 XML 資料中的字元，如果任何字元超出合法 XML 字元的範圍，則會擲回 XmlException 。 啟用字元檢查時，可確保：

• 字元在合法 XML 字元的範圍內，如 W3C XML 1.0 建議的 2.2 Characters 區段所定義。

• 所有 XML 名稱都是有效的，如 W3C XML 1.0 建議的 2.3 通用語法建構 一節所定義。

當此屬性設定為 true 時，這是預設設定， XmlException 如果 XML 檔案包含不合法的字元或不正確 XML 名稱 (，例如，元素名稱開頭為數字) ，則會擲回例外狀況。

如果 XmlReader 正在處理文字資料，則它會始終檢查 XML 名稱和文字內容是否有效，而不論屬性設定。 將 CheckCharacters 設為 false 會關閉字元實體參考的字元檢查。