XmlReaderSettings.ValidationFlags Właściwość

Definicja

Pobiera lub ustawia wartość wskazującą ustawienia walidacji schematu.Gets or sets a value indicating the schema validation settings. To ustawienie dotyczy XmlReader obiektów, które sprawdzają poprawność schematów (WłaściwośćValidationType ustawiona na ValidationType.Schema).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

Wartość właściwości

Bitowa kombinacja wartości wyliczenia, które określają opcje walidacji.A bitwise combination of enumeration values that specify validation options. ProcessIdentityConstraints i AllowXmlAttributes są domyślnie włączone.ProcessIdentityConstraints and AllowXmlAttributes are enabled by default. ProcessInlineSchema, ProcessSchemaLocationi ReportValidationWarnings są domyślnie wyłączone.ProcessInlineSchema, ProcessSchemaLocation, and ReportValidationWarnings are disabled by default.

Przykłady

Poniższy przykład sprawdza poprawność pliku XML względem wbudowanego schematu XML przez włączenie ustawienia ProcessInlineSchema.The following example validates an XML file against an inline XML Schema by enabling the ProcessInlineSchema setting. Czytnik XML jest skonfigurowany do wyświetlania ostrzeżeń dotyczących sprawdzania poprawności, SP zobaczysz również oczekiwane Ostrzeżenie dla elementu głównego.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 

Dane wejścioweInput

W przykładzie zastosowano plik inlineSchema. XML jako dane wejściowe.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>

Dane wyjścioweOutput

Ostrzeżenie: nie znaleziono zgodnego schematu.Warning: Matching schema not found. Nie przeprowadzono weryfikacji.No validation occurred. Nie można znaleźć informacji o schemacie dla elementu "root".Could not find schema information for the element 'root'.

Błąd walidacji: element "xsdHeadCount: liczba pracowników" ma nieprawidłowy element podrzędny "dzielenie".Validation error: The element 'xsdHeadCount:HeadCount' has invalid child element 'division'. Oczekiwano elementu "ID".Expected 'ID'.

Uwagi

Ważne

Flagi walidacji ProcessInlineSchema i ProcessSchemaLocation obiektu XmlReaderSettings nie są ustawiane domyślnie.The ProcessInlineSchema and ProcessSchemaLocation validation flags of an XmlReaderSettings object are not set by default. Po ustawieniu tych flag XmlResolver obiektu XmlReaderSettings jest używany do rozwiązywania lokalizacji schematu napotkanych w dokumencie wystąpienia w XmlReader.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. Jeśli obiekt XmlResolver jest null, lokalizacje schematu nie są rozpoznawane, nawet jeśli są ustawione flagi walidacji ProcessInlineSchema i ProcessSchemaLocation.If the XmlResolver object is null, schema locations are not resolved even if the ProcessInlineSchema and ProcessSchemaLocation validation flags are set.

Schematy dodane podczas walidacji Dodaj nowe typy i można zmienić wynik walidacji zweryfikowanego dokumentu.Schemas added during validation add new types and can change the validation outcome of the document being validated. W związku z tym schematy zewnętrzne powinny być rozpoznawane tylko z zaufanych źródeł.As a result, external schemas should only be resolved from trusted sources.

Wyłączenie flagi ProcessIdentityConstraints (domyślnie włączone) jest zalecane w przypadku walidacji, niezaufanych, dużych dokumentów XML w scenariuszach wysokiej dostępności względem schematu z ograniczeniami tożsamości w ramach dużej części dokumentu.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.

Dotyczy

Zobacz też