XmlReaderSettings.ValidationFlags XmlReaderSettings.ValidationFlags XmlReaderSettings.ValidationFlags XmlReaderSettings.ValidationFlags Property

定義

スキーマ検証の設定を示す値を取得または設定します。Gets or sets a value indicating the schema validation settings. この設定は、スキーマを検証する XmlReader オブジェクトに適用されます (ValidationType.Schema に設定されている ValidationType プロパティ)。This setting applies to XmlReader objects that validate schemas (ValidationType property set to ValidationType.Schema).

public:
 property System::Xml::Schema::XmlSchemaValidationFlags ValidationFlags { System::Xml::Schema::XmlSchemaValidationFlags get(); void set(System::Xml::Schema::XmlSchemaValidationFlags value); };
public System.Xml.Schema.XmlSchemaValidationFlags ValidationFlags { get; set; }
member this.ValidationFlags : System.Xml.Schema.XmlSchemaValidationFlags with get, set
Public Property ValidationFlags As XmlSchemaValidationFlags

プロパティ値

検証オプションを指定する列挙値のビットごとの組み合わせ。A bitwise combination of enumeration values that specify validation options. ProcessIdentityConstraints および AllowXmlAttributes は既定で有効になります。ProcessIdentityConstraints and AllowXmlAttributes are enabled by default. ProcessInlineSchemaProcessSchemaLocation、および ReportValidationWarnings は既定で無効になります。ProcessInlineSchema, ProcessSchemaLocation, and ReportValidationWarnings are disabled by default.

次の例では、 ProcessInlineSchema設定を有効にすることで、インライン xml スキーマに対して xml ファイルを検証します。The following example validates an XML file against an inline XML Schema by enabling the ProcessInlineSchema setting. XML リーダーは検証の警告を表示するように構成されています。 sp には、ルート要素に対して予期される警告も表示されます。The XML reader is configured to display validation warnings, sp you also see the expected warning on the root element.

using System;
using System.Xml;
using System.Xml.Schema;
using System.IO;

public class ValidXSD {

  public static void Main() {

    // Set the validation settings.
    XmlReaderSettings settings = new XmlReaderSettings();
    settings.ValidationType = ValidationType.Schema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ProcessInlineSchema;
    settings.ValidationFlags |= XmlSchemaValidationFlags.ReportValidationWarnings;
    settings.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);

    // Create the XmlReader object.
    XmlReader reader = XmlReader.Create("inlineSchema.xml", settings);

    // Parse the file. 
    while (reader.Read());
    
  }

  // Display any warnings or errors.
  private static void ValidationCallBack (object sender, ValidationEventArgs args) {
     if (args.Severity==XmlSeverityType.Warning)
       Console.WriteLine("\tWarning: Matching schema not found.  No validation occurred." + args.Message);
     else
        Console.WriteLine("\tValidation error: " + args.Message);

  }  

}
Imports System.Xml
Imports System.Xml.Schema
Imports System.IO

public class ValidXSD 

  public shared sub Main() 

    ' Set the validation settings.
    Dim settings as XmlReaderSettings = new XmlReaderSettings()
    settings.ValidationType = ValidationType.Schema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ProcessInlineSchema
    settings.ValidationFlags = settings.ValidationFlags Or XmlSchemaValidationFlags.ReportValidationWarnings
      AddHandler settings.ValidationEventHandler, AddressOf ValidationCallBack

    ' Create the XmlReader object.
    Dim reader as XmlReader = XmlReader.Create("inlineSchema.xml", settings)

    ' Parse the file. 
    while (reader.Read())
    end while
  end sub

  ' Display any warnings or errors.
  private shared sub ValidationCallBack (sender as object, args as ValidationEventArgs)
     if (args.Severity=XmlSeverityType.Warning)
       Console.WriteLine("   Warning: Matching schema not found.  No validation occurred." + args.Message)
     else
        Console.WriteLine("   Validation error: " + args.Message)
     end if
  end sub 

end class 

入力Input

この例では、inlineSchema.xml ファイルを入力として使用します。The example uses the inlineSchema.xml file as input.

<root>
<!--Start of schema-->
<xs:schema xmlns:xs='http://www.w3.org/2001/XMLSchema'
            xmlns='xsdHeadCount'
            targetNamespace='xsdHeadCount'>
    <xs:element name='HeadCount'>
        <xs:complexType>
            <xs:sequence>
                <xs:element name='ID' type='xs:unsignedShort' maxOccurs='unbounded' />
            </xs:sequence>
            <xs:attribute name='division' type='xs:string' use='optional' default='QA'/>
        </xs:complexType>
    </xs:element>
</xs:schema>
<!--End of schema-->
<hc:HeadCount xmlns:hc='xsdHeadCount'>
    <ID>12365</ID>
    <ID>43295</ID>
    <division>Accounting</division>
</hc:HeadCount>
</root>

OutputOutput

警告 : 一致するスキーマが見つかりません。Warning: Matching schema not found. 検証が実行されませんでした。No validation occurred. 要素 'root' のスキーマ情報が見つかりませんでした。Could not find schema information for the element 'root'.

検証エラー: 要素 ' xsdHeadCount: 人員 ' に無効な子要素 ' 除算 ' が含まれています。Validation error: The element 'xsdHeadCount:HeadCount' has invalid child element 'division'. 'ID' を指定してください。"Expected 'ID'.

注釈

重要

ProcessInlineSchema オブジェクトの ProcessSchemaLocation および XmlReaderSettings の検証フラグは、既定では設定されていません。The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. これらのフラグが設定されていると、XmlResolver オブジェクトの XmlReaderSettingsXmlReader のインスタンス ドキュメント中に出現したスキーマの場所を解決するために使用されます。When these flags are set, the XmlResolver of the XmlReaderSettings object is used to resolve schema locations encountered in the instance document in the XmlReader. オブジェクトがnullの場合、およびProcessInlineSchema ProcessSchemaLocation検証フラグが設定されている場合でも、スキーマの場所は解決されません。 XmlResolverIf the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

検証を実行しているときにスキーマを追加すると新しい型が追加されるため、検証しているドキュメントの検証結果を変えることができます。Schemas added during validation add new types and can change the validation outcome of the document being validated. 結果として、信頼できるソースからの外部スキーマだけが解決されるようにする必要があります。As a result, external schemas should only be resolved from trusted sources.

ドキュメントの大部分に対する id 制約を持つスキーマに対して、高可用性シナリオで、信頼されていない大きな XML ドキュメントを検証する場合は、フラグ(既定で有効)を無効にすることをお勧めします。ProcessIdentityConstraintsDisabling the ProcessIdentityConstraints flag (enabled by default) is recommended when validating, untrusted, large XML documents in high availability scenarios against a schema with identity constraints over a large part of the document.

適用対象

こちらもご覧ください