XmlReaderSettings.CheckCharacters プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlReaderSettings.CheckCharacters プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

文字のチェックを行うかどうかを示す値を取得または設定します。

名前空間: System.Xml
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property CheckCharacters As
 Boolean

Visual Basic (使用法)

Dim instance As XmlReaderSettings
Dim value As Boolean

value = instance.CheckCharacters

instance.CheckCharacters = value

C#

public bool CheckCharacters { get;
 set; }

C++

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

J#

/** @property */
public boolean get_CheckCharacters ()

/** @property */
public void set_CheckCharacters (boolean value)

JScript

public function get CheckCharacters
 () : boolean

public function set CheckCharacters
 (value : boolean)

プロパティ値
文字をチェックする場合は true。それ以外の場合は false。既定値は true です。

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

解説

文字をチェックし、何らかの文字が有効な XML 文字の範囲外にある場合は例外をスローするように、リーダーに指示します。文字のチェックには、ドキュメント内の無効な文字のチェックおよび XML 名の有効性のチェック (たとえば、XML 名の最初の文字には数字を使用できない) が含まれます。

詳細については、W3C 勧告『XML 1.0』のセクション 2.2 (http://www.w3.org/TR/REC-xml#charsets) およびセクション 2.3 (http://www.w3.org/TR/REC-xml#NT-Name) を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlReaderSettings クラス
XmlReaderSettings メンバ
System.Xml 名前空間
その他の技術情報
XML リーダーの作成