XmlReaderSettings.CheckCharacters プロパティ


文字のチェックを行うかどうかを示す値を取得または設定します。Gets or sets a value indicating whether to do character checking.

 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



文字をチェックする場合は true。それ以外の場合は falsetrue to do character checking; otherwise false. 既定値は、true です。The default is true.

XmlReader がテキスト データの処理を行う場合は、プロパティの設定に関係なく、XML 名とテキストの内容が有効であることを常にチェックします。If the XmlReader is processing text data, it always checks that the XML names and text content are valid, regardless of the property setting. CheckCharactersfalse に設定すると、文字エンティティ参照に対する文字のチェック機能がオフになります。Setting CheckCharacters to false turns off character checking for character entity references.


このプロパティは、読み取り中の XML データ内の文字をチェックし、 XmlException 有効な xml 文字の範囲外の文字がある場合はをスローするように xml リーダーに指示します。This property instructs the XML reader to check characters in the XML data it's reading and throw an XmlException if any characters are outside the range of legal XML characters. 文字チェックが有効な場合は、以下が保証されます。When character checking is enabled, you are ensured the following:

  • 文字は、W3C 勧告『 XML 1.0 』の「 2.2 文字 」セクションで定義されているように、有効な XML 文字の範囲内にあります。Characters are within the range of legal XML characters, as defined by the 2.2 Characters section of the W3C XML 1.0 Recommendation.

  • W3C 勧告『 XML 1.0 』の「 2.3 共通の構文構造 」セクションで定義されているように、すべての XML 名が有効です。All XML names are valid, as defined by the 2.3 Common Syntactic Constructs section of the W3C XML 1.0 Recommendation.

このプロパティが true (既定の設定) に設定されている場合、 XmlException xml ファイルに無効な文字または無効な xml 名が含まれていると、例外がスローされます (たとえば、要素名が数字で始まる場合)。When this property is set to true, which is the default setting, an XmlException exception is thrown if the XML file contains illegal characters or invalid XML names (for example, an element name starts with a number).