XmlValidatingReader.Schemas プロパティ

[アーティクル]
03/28/2008

検証に使用する XmlSchemaCollection を取得します。

Public ReadOnly Property Schemas As XmlSchemaCollection
[C#]
public XmlSchemaCollection Schemas {get;}
[C++]
public: __property XmlSchemaCollection* get_Schemas();
[JScript]
public function get Schemas() : XmlSchemaCollection;

プロパティ値

検証に使用する XmlSchemaCollection 。

解説

XmlSchemaCollection は、あらかじめ読み込んだ XML-Data Reduced (XDR) と XML スキーマ定義言語 (XSD) スキーマを保持します。このプロパティは、リーダーにスキーマのキャッシュへのアクセス権を与え、リーダーは毎回スキーマを読み込み直さずに検証できます。リーダーは、 XmlSchemaCollection に何も追加しません。

XmlSchemaCollection に、他の名前空間を参照する include 要素または import 要素を格納する XML スキーマ (XSD) が含まれている場合は、他の名前空間のスキーマが検証目的のためだけに読み込まれます。これらのスキーマが明示的にスキーマコレクションに追加されていない場合、コレクションメソッドやプロパティを使用してアクセスできません。たとえば、コレクションにスキーマファイル b.xsd への参照を格納したスキーマファイル a.xsd が含まれている場合、コレクションメソッドまたはプロパティを使用して、アクセスする前に、スキーマコレクションに b.xsd を追加する必要があります。

Schemas プロパティを使用して XmlSchemaCollection にアクセスする場合、 XmlSchemaCollection.Add メソッドは XmlValidatingReader.XmlResolver プロパティで指定された XmlResolver を使用します。

メモ最初の Read 呼び出しの前に、スキーマを XmlSchemaCollection に追加する必要があります。

詳細については、「 XmlValidatingReader を使用した XML の検証」を参照してください。

使用例

[Visual Basic, C#, C++] XmlSchemaCollection に格納されたスキーマを使用して 3 つの XML ファイルを検証する例を次に示します。

 
Option Strict
Option Explicit

Imports System
Imports System.IO
Imports System.Xml
Imports System.Xml.Schema
Imports Microsoft.VisualBasic

Public Class SchemaCollectionSample
    Private doc1 As String = "booksSchema.xml"
    Private doc2 As String = "booksSchemaFail.xml"
    Private doc3 As String = "newbooks.xml"
    Private schema As String = "books.xsd"
    Private schema1 As String = "schema1.xdr"
    
    Private reader As XmlTextReader = Nothing
    Private vreader As XmlValidatingReader = Nothing
    Private m_success As Boolean = True
    
    Public Sub New()

            'Load the schema collection
            Dim xsc As New XmlSchemaCollection()
            xsc.Add("urn:bookstore-schema", schema) 'XSD schema
            xsc.Add("urn:newbooks-schema", schema1) 'XDR schema

            'Validate the files using schemas stored in the collection.
            Validate(doc1, xsc) 'Should pass.
            Validate(doc2, xsc) 'Should fail.   
            Validate(doc3, xsc) 'Should fail. 
        
    End Sub 'New
    
    Public Shared Sub Main()
        Dim validation As New SchemaCollectionSample()
    End Sub 'Main
    
    Private Sub Validate(filename As String, xsc As XmlSchemaCollection)
        
            m_success = True
            Console.WriteLine()
            Console.WriteLine("Validating XML file {0}...", filename.ToString())
            reader = New XmlTextReader(filename)
            
            'Create a validating reader.
            vreader = New XmlValidatingReader(reader)
            
            'Use the schemas stored in the schema collection.
            vreader.Schemas.Add(xsc)
            
            'Set the validation event handler.
            AddHandler vreader.ValidationEventHandler, AddressOf ValidationCallBack
            'Read and validate the XML data.
            While vreader.Read()
            End While
            Console.WriteLine("Validation finished. Validation {0}", IIf(m_success, "successful", "failed"))
            Console.WriteLine()

            'Close the reader.
            vreader.Close()

    End Sub 'Validate
       
    
    Private Sub ValidationCallBack(sender As Object, args As ValidationEventArgs)
        m_success = False
        
        Console.Write((ControlChars.CrLf & ControlChars.Tab & "Validation error: " & args.Message))
    End Sub 'ValidationCallBack 
End Class 'SchemaCollectionSample

[C#] 
using System;
using System.IO;
using System.Xml;
using System.Xml.Schema;

public class SchemaCollectionSample
{
  private const String doc1 = "booksSchema.xml";
  private const String doc2 = "booksSchemaFail.xml";
  private const String doc3 = "newbooks.xml";
  private const String schema = "books.xsd";
  private const String schema1 = "schema1.xdr";
  
  private XmlTextReader reader=null;
  private XmlValidatingReader vreader = null;
  private Boolean m_success = true;

  public SchemaCollectionSample ()
  {
    //Load the schema collection.
    XmlSchemaCollection xsc = new XmlSchemaCollection();
    xsc.Add("urn:bookstore-schema", schema);  //XSD schema
    xsc.Add("urn:newbooks-schema", schema1);  //XDR schema

    //Validate the files using schemas stored in the collection.
    Validate(doc1, xsc); //Should pass.
    Validate(doc2, xsc); //Should fail.   
    Validate(doc3, xsc); //Should fail. 

  }    

  public static void Main ()
  {
      SchemaCollectionSample validation = new SchemaCollectionSample();
  }

  private void Validate(String filename, XmlSchemaCollection xsc)
  {
   
     m_success = true;
     Console.WriteLine();
     Console.WriteLine("Validating XML file {0}...", filename.ToString());
     reader = new XmlTextReader (filename);
        
     //Create a validating reader.
    vreader = new XmlValidatingReader (reader);

     //Validate using the schemas stored in the schema collection.
     vreader.Schemas.Add(xsc);
 
     //Set the validation event handler
     vreader.ValidationEventHandler += new ValidationEventHandler (ValidationCallBack);
     //Read and validate the XML data.
     while (vreader.Read()){}
     Console.WriteLine ("Validation finished. Validation {0}", (m_success==true ? "successful" : "failed"));
     Console.WriteLine();

     //Close the reader.
     vreader.Close();

  } 


  private void ValidationCallBack (object sender, ValidationEventArgs args)
  {
     m_success = false;

     Console.Write("\r\n\tValidation error: " + args.Message);

  }  
}

[C++] 
#using <mscorlib.dll>
#using <System.Xml.dll>
using namespace System;
using namespace System::IO;
using namespace System::Xml;
using namespace System::Xml::Schema;

public __gc class SchemaCollectionSample
{
private:
   XmlTextReader* reader;
   XmlValidatingReader* vreader;
   Boolean m_success;

public:
   SchemaCollectionSample ()
   {
      reader=0;
      vreader = 0;
      m_success = true;
      //Load the schema collection.
      XmlSchemaCollection* xsc = new XmlSchemaCollection();
      String* schema = S"books.xsd";
      String* schema1 = S"schema1.xdr";
      xsc->Add(S"urn:bookstore-schema", schema);  //XSD schema
      xsc->Add(S"urn:newbooks-schema", schema1);  //XDR schema

      String* doc1 = S"booksSchema.xml";
      String* doc2 = S"booksSchemaFail.xml";
      String* doc3 = S"newbooks.xml";
      //Validate the files using schemas stored in the collection.
      Validate(doc1, xsc); //Should pass.
      Validate(doc2, xsc); //Should fail.   
      Validate(doc3, xsc); //Should fail. 

   }    

private:
   void Validate(String* filename, XmlSchemaCollection* xsc)
   {

      m_success = true;
      Console::WriteLine();
      Console::WriteLine(S"Validating XML file {0}...",filename);
      reader = new XmlTextReader (filename);

      //Create a validating reader.
      vreader = new XmlValidatingReader (reader);

      //Validate using the schemas stored in the schema collection.
      vreader->Schemas->Add(xsc);

      //Set the validation event handler
      vreader->ValidationEventHandler += new ValidationEventHandler (this, &SchemaCollectionSample::ValidationCallBack);
      //Read and validate the XML data.
      while (vreader->Read()){}
      Console::WriteLine (S"Validation finished. Validation {0}",(m_success==true?S"successful":S"failed"));
      Console::WriteLine();

      //Close the reader.
      vreader->Close();

   } 


private:
   void ValidationCallBack (Object* /*sender*/, ValidationEventArgs* args)
   {
      m_success = false;

      Console::Write(S"\r\n\tValidation error: {0}", args->Message);

   }  
};

int main ()
{
   new SchemaCollectionSample();
}

[Visual Basic, C#, C++] サンプルでは、次の 5 つの入力ファイルを使用します。

[Visual Basic, C#, C++] booksSchema.xml

<?xml version='1.0'?>
 <bookstore xmlns="urn:bookstore-schema">
   <book genre="autobiography">
     <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">
     <title>The Confidence Man</title>
     <author>
       <first-name>Herman</first-name>
       <last-name>Melville</last-name>
     </author>
     <price>11.99</price>
   </book>
 </bookstore>

[Visual Basic, C#, C++] booksSchemaFail.xml

<?xml version='1.0'?>
 <bookstore xmlns="urn:bookstore-schema">
   <book>
     <author>
       <first-name>Benjamin</first-name>
       <last-name>Franklin</last-name>
     </author>
   </book>
   <book genre="novel">
     <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">
     <title>The Gorgias</title>
     <author>
       <name>Plato</name>
     </author>
     <price>9.99</price>
   </book>
 </bookstore>

[Visual Basic, C#, C++] newbooks.xml

<?xml version='1.0'?>
<bookstore xmlns="urn:newbooks-schema">
  <book genre="novel" style="hardcover">
    <title>The Handmaid's Tale</title>
    <author>
      <first-name>Margaret</first-name>
      <last-name>Atwood</last-name>
    </author>
    <price>19.95</price>
  </book>
  <book genre="novel" style="other">
    <title>The Poisonwood Bible</title>
    <author>
      <first-name>Barbara</first-name>
      <last-name>Kingsolver</last-name>
    </author>
    <price>11.99</price>
  </book>
</bookstore>

[Visual Basic, C#, C++] books.xsd

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
     xmlns="urn:bookstore-schema"
     elementFormDefault="qualified"
     targetNamespace="urn:bookstore-schema">
 
  <xsd:element name="bookstore" type="bookstoreType"/>
 
  <xsd:complexType name="bookstoreType">
   <xsd:sequence maxOccurs="unbounded">
    <xsd:element name="book"  type="bookType"/>
   </xsd:sequence>
  </xsd:complexType>
 
  <xsd:complexType name="bookType">
   <xsd:sequence>
    <xsd:element name="title" type="xsd:string"/>
    <xsd:element name="author" type="authorName"/>
    <xsd:element name="price"  type="xsd:decimal"/>
   </xsd:sequence>
   <xsd:attribute name="genre" type="xsd:string"/>
  </xsd:complexType>
 
  <xsd:complexType name="authorName">
   <xsd:sequence>
    <xsd:element name="first-name"  type="xsd:string"/>
    <xsd:element name="last-name" type="xsd:string"/>
   </xsd:sequence>
  </xsd:complexType>
 
 </xsd:schema>

[Visual Basic, C#, C++] schema1.xdr

<?xml version="1.0"?>
<Schema xmlns="urn:schemas-microsoft-com:xml-data"
        xmlns:dt="urn:schemas-microsoft-com:datatypes">
  <ElementType name="first-name" content="textOnly"/>
  <ElementType name="last-name" content="textOnly"/>
  <ElementType name="name" content="textOnly"/>
  <ElementType name="price" content="textOnly" dt:type="fixed.14.4"/>
  <ElementType name="author" content="eltOnly" order="one">
    <group order="seq">
      <element type="name"/>
    </group>
    <group order="seq">
      <element type="first-name"/>
      <element type="last-name"/>
    </group>
  </ElementType>
  <ElementType name="title" content="textOnly"/>
  <AttributeType name="genre" dt:type="string"/>
  <AttributeType name="style" dt:type="enumeration"
        dt:values="paperback hardcover"/>
  <ElementType name="book" content="eltOnly">
    <attribute type="genre" required="yes"/>
    <attribute type="style" required="yes"/>
    <element type="title"/>
    <element type="author"/>
    <element type="price"/>
  </ElementType>
  <ElementType name="bookstore" content="eltOnly">
    <element type="book"/>
  </ElementType>
</Schema>

[JScript] JScript のサンプルはありません。Visual Basic、C#、および C++ のサンプルを表示するには、このページの左上隅にある言語のフィルタボタンをクリックします。

必要条件

プラットフォーム: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 ファミリ

参照

XmlValidatingReader クラス | XmlValidatingReader メンバ | System.Xml 名前空間

次の方法で共有

XmlValidatingReader.Schemas プロパティ

プロパティ値

解説

使用例

必要条件

参照

その他のリソース