XmlReaderSettings.ValidationFlags Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets or sets a value indicating the schema validation settings. This setting applies to XmlReader objects that validate schemas (ValidationType property set to ValidationType.Schema).

Namespace:   System.Xml
Assembly:  System.Xml (in System.Xml.dll)

public XmlSchemaValidationFlags ValidationFlags { get; set; }

Property Value

Type: System.Xml.Schema.XmlSchemaValidationFlags

A bitwise combination of enumeration values that specify validation options. ProcessIdentityConstraints and AllowXmlAttributes are enabled by default. ProcessInlineSchema, ProcessSchemaLocation, and ReportValidationWarnings are disabled by default.

System_CAPS_security Security Note

The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. 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. If 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.

Disabling 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.

The following example validates an XML file against an inline XML Schema by enabling the ProcessInlineSchema setting. 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);
        Console.WriteLine("\tValidation error: " + args.Message);



The example uses the inlineSchema.xml file as input.

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

Warning:   Matching schema not found. No validation occurred. Could not find schema information for the element 'root'.

Validation error:   The element 'xsdHeadCount:HeadCount' has invalid child element 'division'. Expected 'ID'.

.NET Framework
Available since 2.0
Return to top