XmlReaderSettings.CheckCharacters プロパティ

定義

名前空間:

System.Xml

アセンブリ:

System.Xml.ReaderWriter.dll

Source:

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 の推奨事項の「2.2 文字 」セクションで定義されているように、有効な XML 文字の範囲内です。

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

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

XmlReader がテキスト データの処理を行う場合は、プロパティの設定に関係なく、XML 名とテキストの内容が有効であることを常にチェックします。 CheckCharacters を false に設定すると、文字エンティティ参照に対する文字のチェック機能がオフになります。