Delen via

Schemavalidatie met XPathNavigator

  • Artikel

Met behulp van de XmlDocument klasse kunt u de XML-inhoud in een XmlDocument object op twee manieren valideren. De eerste manier is om de XML-inhoud te valideren met behulp van een validerend XmlReader object en de tweede manier is om de Validate methode van de XmlDocument klasse te gebruiken. U kunt ook alleen-lezenvalidatie van XML-inhoud uitvoeren met behulp van de XPathDocument klasse.

XML-gegevens valideren

De XmlDocument klasse valideert standaard geen XML-document met DTD- of XML-schemadefinitietaal (XSD). Alleen wordt gecontroleerd of het XML-document goed is opgemaakt.

De eerste manier om een XML-document te valideren, is door het document te valideren terwijl het in een XmlDocument object wordt geladen met behulp van een validatieobject XmlReader . De tweede manier is om een eerder niet-getypt XML-document te valideren met behulp van de Validate methode van de XmlDocument klasse. In beide gevallen kunnen wijzigingen in het gevalideerde XML-document opnieuw worden gevalideerd met behulp van de Validate methode van de XmlDocument klasse.

Een document valideren terwijl het wordt geladen

Er wordt een validatieobject XmlReader gemaakt door een XmlReaderSettings object door te geven aan de Create methode van de XmlReader klasse die een XmlReaderSettings object als parameter gebruikt. Het XmlReaderSettings object dat als parameter wordt doorgegeven, heeft een ValidationType eigenschap ingesteld Schema op en een XML-schema voor het XML-document in het object dat is toegevoegd aan Schemas de XmlDocument eigenschap. Het validerende XmlReader object wordt vervolgens gebruikt om het XmlDocument object te maken.

In het volgende voorbeeld wordt het contosoBooks.xml bestand gevalideerd terwijl het in het XmlDocument object wordt geladen door het XmlDocument object te maken met behulp van een validatieobject XmlReader . Omdat het XML-document geldig is volgens het schema, worden er geen schemavalidatiefouten of waarschuwingen gegenereerd.

Imports System  
Imports System.Xml  
Imports System.Xml.Schema  
Imports System.Xml.XPath  
  
Class ValidatingReaderExample  
  
    Shared Sub Main(ByVal args() As String)  
  
        Try  
            Dim settings As XmlReaderSettings = New XmlReaderSettings()  
            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
            settings.ValidationType = ValidationType.Schema  
  
            Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
  
            Dim document As XmlDocument = New XmlDocument()  
            document.Load(reader)  
            Dim navigator As XPathNavigator = document.CreateNavigator()  
  
        Catch e As Exception  
            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message)  
        End Try  
  
    End Sub  
  
    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
  
        Select Case e.Severity  
            Case XmlSeverityType.Error  
                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
                Exit Sub  
            Case XmlSeverityType.Warning  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
                Exit Sub  
        End Select  
  
    End Sub  
  
End Class  

using System;  
using System.Xml;  
using System.Xml.Schema;  
using System.Xml.XPath;  
  
class ValidatingReaderExample  
{  
    static void Main(string[] args)  
    {  
        try  
        {  
            XmlReaderSettings settings = new XmlReaderSettings();  
            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
            settings.ValidationType = ValidationType.Schema;  
  
            XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
  
            XmlDocument document = new XmlDocument();  
            document.Load(reader);  
            XPathNavigator navigator = document.CreateNavigator();  
        }  
        catch (Exception e)  
        {  
            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message);  
        }  
    }  
  
    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
    {  
        switch (e.Severity)  
        {  
            case XmlSeverityType.Error:  
                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
                break;  
            case XmlSeverityType.Warning:  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
                break;  
        }  
    }  
}

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

In het voorbeeld wordt ook de contosoBooks.xsd invoer gebruikt.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.contoso.com/books" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="bookstore">
        <xs:complexType>
            <xs:sequence>
                <xs:element maxOccurs="unbounded" name="book">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="title" type="xs:string" />
                            <xs:element name="author">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element minOccurs="0" name="name" type="xs:string" />
                                        <xs:element minOccurs="0" name="first-name" type="xs:string" />
                                        <xs:element minOccurs="0" name="last-name" type="xs:string" />
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="price" type="xs:decimal" />
                        </xs:sequence>
                        <xs:attribute name="genre" type="xs:string" use="required" />
                        <xs:attribute name="publicationdate" type="xs:date" use="required" />
                        <xs:attribute name="ISBN" type="xs:string" use="required" />
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

In het bovenstaande voorbeeld wordt er een XmlSchemaValidationException gegenereerd wanneer Load een kenmerk of elementtype wordt aangeroepen als dit niet overeenkomt met het overeenkomstige type dat is opgegeven in het validatieschema. Als een ValidationEventHandler waarde is ingesteld voor het valideren XmlReader, wordt de ValidationEventHandler aangeroepen wanneer er een ongeldig type wordt aangetroffen.

Er XmlSchemaException wordt een gegenereerd wanneer een kenmerk of element waarop TypedValue de set is ingesteld invalid , wordt geopend door de XPathNavigator.

De Validity eigenschap kan worden gebruikt om te bepalen of een afzonderlijk kenmerk of element geldig is bij het openen van kenmerken of elementen met de XPathNavigator.

Notitie

Wanneer een XML-document wordt geladen in een XmlDocument object met een gekoppeld schema dat standaardwaarden definieert, behandelt het XmlDocument object deze standaardwaarden alsof ze in het XML-document worden weergegeven. Dit betekent dat de IsEmptyElement eigenschap altijd wordt geretourneerd false voor een element dat standaard is ingesteld vanuit het schema, zelfs als deze in het XML-document is geschreven als een leeg element.

Een document valideren met behulp van de validatiemethode

De Validate methode van de XmlDocument klasse valideert het XML-document in een XmlDocument object op basis van de schema's die zijn opgegeven in de eigenschap van Schemas het XmlDocument object en voert infoset-uitbreidingen uit. Het resultaat is een eerder niet-getypt XML-document in het XmlDocument object dat is vervangen door een getypt document.

Het XmlDocument object rapporteert schemavalidatiefouten en waarschuwingen met behulp van de ValidationEventHandler gemachtigde die als parameter aan de Validate methode is doorgegeven.

In het volgende voorbeeld wordt het contosoBooks.xml bestand in het XmlDocument object gevalideerd op basis van het contosoBooks.xsd schema in de eigenschap van Schemas het XmlDocument object.

Imports System  
Imports System.Xml  
Imports System.Xml.Schema  
Imports System.Xml.XPath  
  
Class ValidateExample  
  
    Shared Sub Main(ByVal args() As String)  
  
        Dim document As XmlDocument = New XmlDocument()  
        document.Load("contosoBooks.xml")  
        Dim navigator As XPathNavigator = document.CreateNavigator()  
  
        document.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
        Dim validation As ValidationEventHandler = New ValidationEventHandler(AddressOf SchemaValidationHandler)  
  
        document.Validate(validation)  
  
    End Sub  
  
    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
  
        Select Case e.Severity  
            Case XmlSeverityType.Error  
                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
                Exit Sub  
            Case XmlSeverityType.Warning  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
                Exit Sub  
        End Select  
  
    End Sub  
  
End Class  

using System;  
using System.Xml;  
using System.Xml.Schema;  
using System.Xml.XPath;  
  
class ValidateExample  
{  
    static void Main(string[] args)  
    {  
        XmlDocument document = new XmlDocument();  
        document.Load("contosoBooks.xml");  
        XPathNavigator navigator = document.CreateNavigator();  
  
        document.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
        ValidationEventHandler validation = new ValidationEventHandler(SchemaValidationHandler);  
  
        document.Validate(validation);  
    }  
  
    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
    {  
        switch (e.Severity)  
        {  
            case XmlSeverityType.Error:  
                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
                break;  
            case XmlSeverityType.Warning:  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
                break;  
        }  
    }  
}

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

In het voorbeeld wordt ook de contosoBooks.xsd invoer gebruikt.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.contoso.com/books" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="bookstore">
        <xs:complexType>
            <xs:sequence>
                <xs:element maxOccurs="unbounded" name="book">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="title" type="xs:string" />
                            <xs:element name="author">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element minOccurs="0" name="name" type="xs:string" />
                                        <xs:element minOccurs="0" name="first-name" type="xs:string" />
                                        <xs:element minOccurs="0" name="last-name" type="xs:string" />
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="price" type="xs:decimal" />
                        </xs:sequence>
                        <xs:attribute name="genre" type="xs:string" use="required" />
                        <xs:attribute name="publicationdate" type="xs:date" use="required" />
                        <xs:attribute name="ISBN" type="xs:string" use="required" />
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Wijzigingen valideren

Nadat wijzigingen zijn aangebracht in een XML-document, kunt u de wijzigingen valideren op basis van het schema voor het XML-document met behulp van de Validate methode van de XmlDocument klasse.

In het volgende voorbeeld wordt het contosoBooks.xml bestand gevalideerd terwijl het in het XmlDocument object wordt geladen door het XmlDocument object te maken met behulp van een validatieobject XmlReader . Het XML-document wordt gevalideerd terwijl het wordt geladen zonder schemavalidatiefouten of waarschuwingen te genereren. In het voorbeeld worden vervolgens twee wijzigingen aangebracht in het XML-document die ongeldig zijn volgens het contosoBooks.xsd schema. Met de eerste wijziging wordt een ongeldig onderliggend element ingevoegd dat resulteert in een schemavalidatiefout. Met de tweede wijziging wordt de waarde van een getypt knooppunt ingesteld op een waarde die ongeldig is volgens het type van het knooppunt dat resulteert in een uitzondering.

Imports System  
Imports System.Xml  
Imports System.Xml.Schema  
Imports System.Xml.XPath  
  
Class ValidatingReaderExample  
  
    Shared Sub Main(ByVal args() As String)  
  
        Try  
            Dim settings As XmlReaderSettings = New XmlReaderSettings()  
            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd")  
            settings.ValidationType = ValidationType.Schema  
  
            Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml", settings)  
  
            Dim document As XmlDocument = New XmlDocument()  
            document.Load(reader)  
            Dim navigator As XPathNavigator = document.CreateNavigator()  
  
            Dim validation As ValidationEventHandler = New ValidationEventHandler(AddressOf SchemaValidationHandler)  
  
            navigator.MoveToChild("bookstore", "http://www.contoso.com/books")  
            navigator.MoveToChild("book", "http://www.contoso.com/books")  
            navigator.MoveToChild("author", "http://www.contoso.com/books")  
  
            navigator.AppendChild("<title>Book Title</title>")  
  
            document.Validate(validation)  
  
            navigator.MoveToParent()  
            navigator.MoveToChild("price", "http://www.contoso.com/books")  
            navigator.SetTypedValue(DateTime.Now)  
        Catch e As Exception  
            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message)  
        End Try  
  
    End Sub  
  
    Shared Sub SchemaValidationHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)  
  
        Select Case e.Severity  
            Case XmlSeverityType.Error  
                Console.WriteLine("Schema Validation Error: {0}", e.Message)  
                Exit Sub  
            Case XmlSeverityType.Warning  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message)  
                Exit Sub  
        End Select  
  
    End Sub  
  
End Class  

using System;  
using System.Xml;  
using System.Xml.Schema;  
using System.Xml.XPath;  
  
class ValidatingReaderExample  
{  
    static void Main(string[] args)  
    {  
        try  
        {  
            XmlReaderSettings settings = new XmlReaderSettings();  
            settings.Schemas.Add("http://www.contoso.com/books", "contosoBooks.xsd");  
            settings.ValidationType = ValidationType.Schema;  
  
            XmlReader reader = XmlReader.Create("contosoBooks.xml", settings);  
  
            XmlDocument document = new XmlDocument();  
            document.Load(reader);  
            XPathNavigator navigator = document.CreateNavigator();  
  
            ValidationEventHandler validation = new ValidationEventHandler(SchemaValidationHandler);  
  
            navigator.MoveToChild("bookstore", "http://www.contoso.com/books");  
            navigator.MoveToChild("book", "http://www.contoso.com/books");  
            navigator.MoveToChild("author", "http://www.contoso.com/books");  
  
            navigator.AppendChild("<title>Book Title</title>");  
  
            document.Validate(validation);  
  
            navigator.MoveToParent();  
            navigator.MoveToChild("price", "http://www.contoso.com/books");  
            navigator.SetTypedValue(DateTime.Now);  
        }  
        catch (Exception e)  
        {  
            Console.WriteLine("ValidatingReaderExample.Exception: {0}", e.Message);  
        }  
    }  
  
    static void SchemaValidationHandler(object sender, ValidationEventArgs e)  
    {  
        switch (e.Severity)  
        {  
            case XmlSeverityType.Error:  
                Console.WriteLine("Schema Validation Error: {0}", e.Message);  
                break;  
            case XmlSeverityType.Warning:  
                Console.WriteLine("Schema Validation Warning: {0}", e.Message);  
                break;  
        }  
    }  
}

In het voorbeeld wordt het contosoBooks.xml bestand als invoer gebruikt.

<?xml version="1.0" encoding="utf-8" ?>
<bookstore xmlns="http://www.contoso.com/books">
    <book genre="autobiography" publicationdate="1981-03-22" ISBN="1-861003-11-0">
        <title>The Autobiography of Benjamin Franklin</title>
        <author>
            <first-name>Benjamin</first-name>
            <last-name>Franklin</last-name>
        </author>
        <price>8.99</price>
    </book>
    <book genre="novel" publicationdate="1967-11-17" ISBN="0-201-63361-2">
        <title>The Confidence Man</title>
        <author>
            <first-name>Herman</first-name>
            <last-name>Melville</last-name>
        </author>
        <price>11.99</price>
    </book>
    <book genre="philosophy" publicationdate="1991-02-15" ISBN="1-861001-57-6">
        <title>The Gorgias</title>
        <author>
            <name>Plato</name>
        </author>
        <price>9.99</price>
    </book>
</bookstore>

In het voorbeeld wordt ook de contosoBooks.xsd invoer gebruikt.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="http://www.contoso.com/books" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="bookstore">
        <xs:complexType>
            <xs:sequence>
                <xs:element maxOccurs="unbounded" name="book">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="title" type="xs:string" />
                            <xs:element name="author">
                                <xs:complexType>
                                    <xs:sequence>
                                        <xs:element minOccurs="0" name="name" type="xs:string" />
                                        <xs:element minOccurs="0" name="first-name" type="xs:string" />
                                        <xs:element minOccurs="0" name="last-name" type="xs:string" />
                                    </xs:sequence>
                                </xs:complexType>
                            </xs:element>
                            <xs:element name="price" type="xs:decimal" />
                        </xs:sequence>
                        <xs:attribute name="genre" type="xs:string" use="required" />
                        <xs:attribute name="publicationdate" type="xs:date" use="required" />
                        <xs:attribute name="ISBN" type="xs:string" use="required" />
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

In het bovenstaande voorbeeld worden twee wijzigingen aangebracht in het XML-document in het XmlDocument object. Wanneer het XML-document is geladen, zijn eventuele schemavalidatiefouten verwerkt door de methode voor de validatiegebeurtenishandler en naar de console geschreven.

In dit voorbeeld zijn de validatiefouten geïntroduceerd nadat het XML-document is geladen en zijn gevonden met behulp van de Validate methode van de XmlDocument klasse.

Wijzigingen die zijn aangebracht met behulp van de SetTypedValue methode van de XPathNavigator klasse, hebben tot gevolg InvalidCastException dat de nieuwe waarde ongeldig is volgens het schematype van het knooppunt.

Zie het onderwerp XML-gegevens wijzigen met behulp van XPathNavigator voor meer informatie over het wijzigen van waarden met behulp van de SetTypedValue methode.

Validatie met het kenmerk Alleen-lezen

De XPathDocument klasse is een alleen-lezenweergave in het geheugen van een XML-document. Zowel de XPathDocument klasse als de XmlDocument klasse maken XPathNavigator objecten om door XML-documenten te navigeren en te bewerken. Omdat de XPathDocument klasse een alleen-lezenklasse is, kan het XML-document dat in het XPathDocument object is opgenomen, XPathNavigator niet worden bewerkt door objecten die worden geretourneerd door XPathDocument objecten.

In het geval van validatie kunt u een XPathDocument object maken, net zoals u een XmlDocument object maakt met behulp van een validatieobject XmlReader , zoals eerder in dit onderwerp is beschreven. Het XPathDocument object valideert het XML-document terwijl het wordt geladen, maar omdat u de XML-gegevens in het XPathDocument object niet kunt bewerken, kunt u het XML-document niet opnieuw valideren.

Zie het onderwerp Xml-gegevens lezen met XPathDocument en XmlDocument voor meer informatie over alleen-lezen en bewerkbare XPathNavigator objecten.

Zie ook