XmlReaderSettings.CheckCharacters プロパティ

定義

名前空間:

System.Xml

アセンブリ:

netstandard.dll, 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 文字の範囲外の文字がある場合は XmlException をスローするように XML リーダーに指示します。 文字チェックが有効になっている場合は、次の内容が保証されます。

• 文字は、W3C XML 1.0 Recommendation の 2.2 文字 セクションで定義されているように、有効な XML 文字の範囲内です。

• W3C XML 1.0 の推奨事項の 2.3 共通構文構造 セクションで定義されているように、すべての XML 名が有効です。

このプロパティが既定の設定である true に設定されている場合、XML ファイルに無効な文字または無効な XML 名が含まれている場合 (たとえば、要素名が数字で始まる)、 XmlException 例外がスローされます。

XmlReaderがテキスト データを処理している場合、プロパティの設定に関係なく、XML 名とテキスト コンテンツが有効であることが常に確認されます。 CheckCharactersをfalseに設定すると、文字エンティティ参照の文字チェックがオフになります。