ConformanceLevel 列挙型


XmlReader オブジェクトおよび XmlWriter オブジェクトで実行する、入力チェックまたは出力チェックの量を指定します。Specifies the amount of input or output checking that XmlReader and XmlWriter objects perform.

public enum class ConformanceLevel
public enum ConformanceLevel
type ConformanceLevel = 
Public Enum ConformanceLevel


Auto 0

XmlReader オブジェクトまたは XmlWriter オブジェクトは、ドキュメント レベルのチェックまたはフラグメント レベルのチェックを実行する必要があるかどうかを自動的に検出し、適切なチェックを実行します。The XmlReader or XmlWriter object automatically detects whether document-level or fragment-level checking should be performed, and does the appropriate checking. 別の XmlReader オブジェクトまたは XmlWriter オブジェクトをラップしている場合、外側のオブジェクトは追加の準拠のチェックを実行しません。If you're wrapping another XmlReader or XmlWriter object, the outer object doesn't do any additional conformance checking. 準拠のチェックは、基になるオブジェクトだけで実行されます。Conformance checking is left up to the underlying object.

準拠レベルの決定方法の詳細については、ConformanceLevel プロパティと ConformanceLevel プロパティを参照してください。See the ConformanceLevel and ConformanceLevel properties for details on how the compliance level is determined.

Document 2

XML データは、W3C によって定義された整形式の XML 1.0 ドキュメントのルールに準拠します。The XML data complies with the rules for a well-formed XML 1.0 document, as defined by the W3C. このレベルのチェックにより、どのプロセッサでも、読み書きされるストリームを XML 1.0 ドキュメントとして使用できることが保証されます。This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 document.

Fragment 1

XML データは、W3C によって定義されている、整形式の XML フラグメントです。The XML data is a well-formed XML fragment, as defined by the W3C. この準拠レベルは、ルート要素がない可能性があっても、それ以外は整形式の XML ドキュメントを表します。This conformance level represents an XML document that might not have a root element but is otherwise well-formed. このレベルのチェックにより、どのプロセッサでも、読み書きされるストリームを XML 1.0 の外部解析対象エンティティとして使用できることが保証されます。This level of checking ensures that the stream being read or written can be consumed by any processor as an XML 1.0 external parsed entity].


XML リーダーまたはライターのインスタンスを作成するときに、クラスまたはクラスを使用して、 XmlReaderSettings XmlWriterSettings 新しいインスタンスでサポートする機能を指定できます。When you create an XML reader or writer instance, you can use the XmlReaderSettings or XmlWriterSettings class to specify the features that you want the new instance to support. 構成できる機能の1つは、XML データに適用する準拠レベルです。One of the features that you can configure is the level of conformance you want to enforce on the XML data.

準拠しているリーダーまたはライターを作成すると、処理されている XML データが、指定した準拠レベルに準拠していることが保証されます。Creating a compliant reader or writer guarantees that the XML data being processed complies with the specified conformance level. 読み取りまたは書き込みが行われているストリームが準拠レベルに準拠していない場合は、例外がスローされます。If the stream being read or written doesn't comply with the conformance level, an exception is thrown.

列挙メンバーによるドキュメントレベルのチェックでは、 ConformanceLevel.Document フラグメントレベルのチェック (メンバー) が適用され、 ConformanceLevel.Fragment 次のことも保証されます。Document-level checks with the ConformanceLevel.Document enumeration member enforce fragment-level checks (the ConformanceLevel.Fragment member) and also ensure the following:

  • 最上位レベルの項目に、XML 宣言、DTD、要素、コメント、空白、または処理命令以外のノードがありません。The top-level item doesn't have any nodes other than the XML declaration, DTD, element, comment, white space, or processing instruction.

  • XML データには、最上位レベルの要素ノードが1つだけあります。The XML data has one and only one top-level element node.