HOW TO: Validate an XML Document by Using Multiple Schemas in Visual Basic .NET (317595)



The information in this article applies to:

  • Microsoft Visual Basic .NET (2003)
  • Microsoft Visual Basic .NET (2002)
  • Microsoft XML Classes (included with the .NET Framework 1.0)
  • Microsoft XML Classes (included with the .NET Framework 1.1)

This article was previously published under Q317595
For a Microsoft Visual C# .NET version of this article, see 318505.

This article refers to the following Microsoft .NET Framework Class Library namespaces:
  • System.Xml
  • System.Xml.Schema
  • System.IO

IN THIS TASK

SUMMARY

This step-by-step article describes how to use the XmlValidatingReader object to validate an Extensible Markup Language (XML) file with multiple XML Schema Definition Language (XSD) schemas. The code sample uses the XmlSchemaCollection object to cache the schemas. For more information about the XmlValidatingReader and the XmlSchemaCollection classes, see the REFERENCES section.

If the namespace is already associated with another schema in the collection, the schema that you add replaces the original schema in the collection. For example, the following code removes the Authors.xsd file from the collection and adds the Names.xsd file to the collection:
schemaColl.Add("urn:author", "authors.xsd");
schemaColl.Add("urn:author", "names.xsd");
				
The XML file is always validated against the last schema.

back to the top

Requirements

The following list outlines the recommended hardware, software, network infrastructure, and service packs that you are required:
  • Microsoft Visual Studio .NET installed on a compatible Microsoft Windows operating system
This article assumes that you are familiar with the following topics:
  • Microsoft Visual Basic .NET
  • XML standards
  • XSD schemas
back to the top

Create the Book.xsd File

  1. Open a text editor such as Notepad.
  2. Copy and paste the following code into Notepad:
    <xs:schema xmlns="urn:bookstore-schema"
             targetNamespace="urn:bookstore-schema"
             xmlns:xs="http://www.w3.org/2001/XMLSchema">
       <xs:element name="book">
          <xs:complexType>
             <xs:simpleContent>
                <xs:extension base="xs:string">
                   <xs:attribute name="price" type="xs:decimal" />
                </xs:extension>
             </xs:simpleContent>
          </xs:complexType>
       </xs:element>
    </xs:schema>
    					
  3. Save the file as C:\Book.xsd.
back to the top

Create the Tape.xsd File

  1. Open a text editor such as Notepad.
  2. Copy and paste the following code into Notepad:
    <xs:schema xmlns="urn:tapestore-schema"
             targetNamespace="urn:tapestore-schema"
             xmlns:xs="http://www.w3.org/2001/XMLSchema">
       <xs:element name="tape" type="xs:string"/>
    </xs:schema>
    					
  3. Save the file as C:\Tape.xsd.
back to the top

Create the Mixed.xml File

  1. Open a text editor such as Notepad.
  2. Copy and paste the following code into Notepad:
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns="urn:dvdstore-schema" targetNamespace="urn:dvdstore-schema">
        <xs:element name="dvd" type="xs:string" />
    </xs:schema>
      <pb:book price="7.99" xmlns:pb="urn:bookstore-schema">The Autobiography of Benjamin Franklin</pb:book>
      <pd:dvd xmlns:pd="urn:dvdstore-schema">The Godfather</pd:dvd>
      <pt:tape xmlns:pt="urn:tapestore-schema" xsi:schemaLocation="urn:tapestore-schema tape.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">Il Postino</pt:tape>
    					
  3. Save the file as C:\Mixed.xml.
NOTE: The XML file also has an inline schema; therefore, this XML file must validate against three schemas.

back to the top

Create a Visual Basic .NET Project

  1. Start Visual Studio .NET.
  2. On the File menu, point to New, and then click Project.
  3. Click Visual Basic Projects under Project Types, click Windows Application under Templates, and then click OK. Form1 is added to the project by default.
  4. Drag a Button control to Form1.
  5. Add the following namespaces to the top of the form:
    Imports System.Xml
    Imports System.Xml.Schema
    Imports System.IO
    					
  6. Add the following sub procedure to create a ValidationEventHandler delegate that raises validation errors in the XmlValidatingReader object:
    Public Sub MyvalidationEventHandle(ByVal sender As Object, ByVal args As ValidationEventArgs)
           Console.WriteLine(args.Message)
        End Sub
    					
  7. Paste the following code in the Button1_Click event procedure:
     Dim myschemacoll As New XmlSchemaCollection()
            Dim vr As XmlValidatingReader
            Dim stream As FileStream
            Try
                stream = New FileStream("c:\Mixed.xml", FileMode.Open)<BR/>
                'Load the XmlValidatingReader.
                vr = New XmlValidatingReader(stream, XmlNodeType.Element, Nothing)
    
                'Add the schemas to the XmlSchemaCollection object.
                myschemacoll.Add("urn:bookstore-schema", "c:\Book.xsd")
                myschemacoll.Add("urn:tapestore-schema", "c:\tape.xsd")
                vr.Schemas.Add(myschemacoll)
                vr.ValidationType = ValidationType.Schema
                AddHandler vr.ValidationEventHandler, AddressOf MyvalidationEventHandle
    
                While vr.Read()
                End While
                Console.WriteLine("Validation completed")
            'This code catches any XML exceptions. 
            Catch XmlExp As XmlException
                Console.WriteLine(XmlExp.Message)
            'This code catches any XML schema exceptions.
            Catch XmlSchemaExp As XmlSchemaException
                Console.WriteLine(XmlSchemaExp.Message)
            'This code catches any standard exceptions.
            Catch GeneralExp As Exception
                Console.WriteLine(GeneralExp.Message)
            Finally
            'Clean up.
                vr = Nothing
                myschemacoll = Nothing
                stream = Nothing
            End Try
    					
  8. When the following message appears in the output window, the XML document is valid against all three of the schemas that it references:

    Validation completed
    						

back to the top

REFERENCES

For more information, see the following Microsoft .NET Framework Class Library documentation: For additional information, click the article numbers below to view the articles in the Microsoft Knowledge Base:

313826 INFO: Roadmap for XML Schemas in the .NET Framework

313651 INFO: Roadmap for XML in the .NET Framework

back to the top

Modification Type:MajorLast Reviewed:9/24/2003
Keywords:kbHOWTOmaster KB317595 kbAudDeveloper