XmlReaderSettings.CheckCharacters プロパティ
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
文字のチェックを行うかどうかを示す値を取得または設定します。
public:
property bool CheckCharacters { bool get(); void set(bool value); };public bool CheckCharacters { get; set; }member this.CheckCharacters : bool with get, setPublic Property CheckCharacters As 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 に設定すると、文字エンティティ参照に対する文字のチェック機能がオフになります。
| 製品 | バージョン |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.0, 1.1, 1.2, 1.3, 1.4, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
.NET に関するフィードバック
.NET はオープンソース プロジェクトです。 フィードバックを提供するにはリンクを選択します。