XmlSchemaValidator 밀어넣기 기반 유효성 검사

아티클
08/22/2008

업데이트: November 2007

XmlSchemaValidator 클래스는 밀어넣기 기반 방식으로 XML 스키마에 대해 XML 데이터의 유효성을 검사할 수 있는 효과적인 고성능 메커니즘을 제공합니다. 예를 들어, XmlSchemaValidator 클래스를 사용하면 XML 문서로 serialize한 다음 유효성 검사 XML 판독기를 사용하여 문서를 다시 구문 분석할 필요 없이 내부에서 직접 XML Infoset의 유효성을 검사할 수 있습니다.

사용자 지정 XML 데이터 소스에 대한 유효성 검사 엔진을 만드는 등의 고급 시나리오에서 또는 유효성 검사 XML 작성기를 만드는 방법으로 XmlSchemaValidator 클래스를 사용할 수 있습니다.

다음은 XmlSchemaValidator 클래스를 사용하여 contosoBooks.xsd 스키마에 대해 contosoBooks.xml 파일의 유효성을 검사하는 예제입니다. 이 예제에서는 XmlSerializer 클래스를 사용하여 contosoBooks.xml 파일을 deserialize하고 노드 값을 XmlSchemaValidator 클래스의 메서드에 전달합니다.

참고:
이 예제는 이 항목의 전체 단원에서 사용됩니다.

Imports System
Imports System.Xml
Imports System.Xml.Schema
Imports System.Xml.Serialization

Namespace Microsoft.Samples.Xml.Schema

    Class XmlSchemaValidatorExamples

        Shared Sub Main()

            ' The XML document to deserialize into the XmlSerializer object.
            Dim reader As XmlReader = XmlReader.Create("contosoBooks.xml")

            ' The XmlSerializer object.
            Dim serializer As XmlSerializer = New XmlSerializer(GetType(ContosoBooks))
            Dim books As ContosoBooks = CType(serializer.Deserialize(reader), ContosoBooks)

            ' The XmlSchemaSet object containing the schema used to validate the XML document.
            Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()
            schemaSet.Add("https://www.contoso.com/books", "contosoBooks.xsd")

            ' The XmlNamespaceManager object used to handle namespaces.
            Dim manager As XmlNamespaceManager = New XmlNamespaceManager(reader.NameTable)

            ' Assign a ValidationEventHandler to handle schema validation warnings and errors.
            Dim validator As XmlSchemaValidator = New XmlSchemaValidator(reader.NameTable, schemaSet, manager, XmlSchemaValidationFlags.None)
            'validator.ValidationEventHandler += New ValidationEventHandler(SchemaValidationEventHandler)
            AddHandler validator.ValidationEventHandler, AddressOf SchemaValidationEventHandler

            ' Initialize the XmlSchemaValidator object.
            validator.Initialize()

            ' Validate the bookstore element, verify that all required attributes are present
            ' and prepare to validate child content.
            validator.ValidateElement("bookstore", "https://www.contoso.com/books", Nothing)
            validator.ValidateEndOfAttributes(Nothing)

            ' Get the next exptected element in the bookstore context.
            Dim particles() As XmlSchemaParticle = validator.GetExpectedParticles()
            Dim nextElement As XmlSchemaElement = particles(0)
            Console.WriteLine("Expected Element: '{0}'", nextElement.Name)

            For Each book As BookType In books.book
                ' Validate the book element.
                validator.ValidateElement("book", "https://www.contoso.com/books", Nothing)

                ' Get the exptected attributes for the book element.
                Console.Write(vbCrLf & "Expected attributes: ")
                Dim attributes() As XmlSchemaAttribute = validator.GetExpectedAttributes()
                For Each attribute As XmlSchemaAttribute In attributes
                    Console.Write("'{0}' ", attribute.Name)
                Next
                Console.WriteLine()

                ' Validate the genre attribute and display its post schema validation information.
                If Not book.Genre Is Nothing Then
                    validator.ValidateAttribute("genre", "", book.Genre, schemaInfo)
                End If
                DisplaySchemaInfo()

                ' Validate the publicationdate attribute and display its post schema validation information.
                If Not book.PublicationDate = Nothing Then
                    validator.ValidateAttribute("publicationdate", "", dateTimeGetter(book.PublicationDate), schemaInfo)
                End If
                DisplaySchemaInfo()

                ' Validate the ISBN attribute and display its post schema validation information.
                If Not book.Isbn Is Nothing Then
                    validator.ValidateAttribute("ISBN", "", book.Isbn, schemaInfo)
                End If
                DisplaySchemaInfo()

                ' Verify that all required attributes of the book element are present
                ' and prepare to validate child content.
                validator.ValidateEndOfAttributes(Nothing)

                ' Validate the title element and its content.
                validator.ValidateElement("title", "https://www.contoso.com/books", Nothing)
                validator.ValidateEndElement(Nothing, book.Title)

                ' Validate the author element, verify that all required attributes are present
                ' and prepare to validate child content.
                validator.ValidateElement("author", "https://www.contoso.com/books", Nothing)
                validator.ValidateEndOfAttributes(Nothing)

                If Not book.Author.Name Is Nothing Then
                    ' Validate the name element and its content.
                    validator.ValidateElement("name", "https://www.contoso.com/books", Nothing)
                    validator.ValidateEndElement(Nothing, book.Author.Name)
                End If

                If Not book.Author.FirstName Is Nothing Then
                    ' Validate the first-name element and its content.
                    validator.ValidateElement("first-name", "https://www.contoso.com/books", Nothing)
                    validator.ValidateEndElement(Nothing, book.Author.FirstName)

                End If

                If Not book.Author.LastName Is Nothing Then
                    ' Validate the last-name element and its content.
                    validator.ValidateElement("last-name", "https://www.contoso.com/books", Nothing)
                    validator.ValidateEndElement(Nothing, book.Author.LastName)
                End If

                ' Validate the content of the author element.
                validator.ValidateEndElement(Nothing)

                ' Validate the price element and its content.
                validator.ValidateElement("price", "https://www.contoso.com/books", Nothing)
                validator.ValidateEndElement(Nothing, book.Price)

                ' Validate the content of the book element.
                validator.ValidateEndElement(Nothing)
            Next

            ' Validate the content of the bookstore element.
            validator.ValidateEndElement(Nothing)

            ' Close the XmlReader object.
            reader.Close()

        End Sub

        Shared schemaInfo As XmlSchemaInfo = New XmlSchemaInfo()
        Shared dateTimeGetterContent As Object

        Shared Function dateTimeGetterHandle() As Object

            Return dateTimeGetterContent

        End Function

        Shared Function dateTimeGetter(ByVal dateTime As DateTime) As XmlValueGetter

            dateTimeGetterContent = dateTime
            Return New XmlValueGetter(AddressOf dateTimeGetterHandle)

        End Function

        Shared Sub DisplaySchemaInfo()

            If Not schemaInfo.SchemaElement Is Nothing Then
                Console.WriteLine("Element '{0}' with type '{1}' is '{2}'", schemaInfo.SchemaElement.Name, schemaInfo.SchemaType, schemaInfo.Validity)
            ElseIf Not schemaInfo.SchemaAttribute Is Nothing Then
                Console.WriteLine("Attribute '{0}' with type '{1}' is '{2}'", schemaInfo.SchemaAttribute.Name, schemaInfo.SchemaType, schemaInfo.Validity)
            End If

        End Sub

        Shared Sub SchemaValidationEventHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)

            Select Case e.Severity
                Case XmlSeverityType.Error
                    Console.WriteLine(vbCrLf & "Error: {0}", e.Message)
                    Exit Sub
                Case XmlSeverityType.Warning
                    Console.WriteLine(vbCrLf & "Warning: {0}", e.Message)
                    Exit Sub
            End Select

        End Sub

    End Class

    <XmlRootAttribute("bookstore", Namespace:="https://www.contoso.com/books", IsNullable:=False)> _
    Public Class ContosoBooks

        <XmlElementAttribute("book")> _
        Public book() As BookType

    End Class

    Public Class BookType

        <XmlAttributeAttribute("genre")> _
        Public Genre As String

        <XmlAttributeAttribute("publicationdate", DataType:="date")> _
        Public PublicationDate As DateTime

        <XmlAttributeAttribute("ISBN")> _
        Public Isbn As String

        <XmlElementAttribute("title")> _
        Public Title As String

        <XmlElementAttribute("author")> _
        Public Author As BookAuthor

        <XmlElementAttribute("price")> _
        Public Price As Decimal

    End Class

    Public Class BookAuthor

        <XmlElementAttribute("name")> _
        Public Name As String

        <XmlElementAttribute("first-name")> _
        Public FirstName As String

        <XmlElementAttribute("last-name")> _
        Public LastName As String

    End Class

End Namespace

using System;
using System.Xml;
using System.Xml.Schema;
using System.Xml.Serialization;

namespace Microsoft.Samples.Xml.Schema
{
    class XmlSchemaValidatorExamples
    {
        static void Main()
        {
            // The XML document to deserialize into the XmlSerializer object.
            XmlReader reader = XmlReader.Create("contosoBooks.xml");

            // The XmlSerializer object.
            XmlSerializer serializer = new XmlSerializer(typeof(ContosoBooks));
            ContosoBooks books = (ContosoBooks)serializer.Deserialize(reader);

            // The XmlSchemaSet object containing the schema used to validate the XML document.
            XmlSchemaSet schemaSet = new XmlSchemaSet();
            schemaSet.Add("https://www.contoso.com/books", "contosoBooks.xsd");

            // The XmlNamespaceManager object used to handle namespaces.
            XmlNamespaceManager manager = new XmlNamespaceManager(reader.NameTable);

            // Assign a ValidationEventHandler to handle schema validation warnings and errors.
            XmlSchemaValidator validator = new XmlSchemaValidator(reader.NameTable, schemaSet, manager, XmlSchemaValidationFlags.None);
            validator.ValidationEventHandler += new ValidationEventHandler(SchemaValidationEventHandler);

            // Initialize the XmlSchemaValidator object.
            validator.Initialize();

            // Validate the bookstore element, verify that all required attributes are present
            // and prepare to validate child content.
            validator.ValidateElement("bookstore", "https://www.contoso.com/books", null);
            validator.ValidateEndOfAttributes(null);

            // Get the next exptected element in the bookstore context.
            XmlSchemaParticle[] particles = validator.GetExpectedParticles();
            XmlSchemaElement nextElement = particles[0] as XmlSchemaElement;
            Console.WriteLine("Expected Element: '{0}'", nextElement.Name);

            foreach (BookType book in books.Book)
            {
                // Validate the book element.
                validator.ValidateElement("book", "https://www.contoso.com/books", null);

                // Get the exptected attributes for the book element.
                Console.Write("\nExpected attributes: ");
                XmlSchemaAttribute[] attributes = validator.GetExpectedAttributes();
                foreach (XmlSchemaAttribute attribute in attributes)
                {
                    Console.Write("'{0}' ", attribute.Name);
                }
                Console.WriteLine();

                // Validate the genre attribute and display its post schema validation information.
                if (book.Genre != null)
                {
                    validator.ValidateAttribute("genre", "", book.Genre, schemaInfo);
                }
                DisplaySchemaInfo();

                // Validate the publicationdate attribute and display its post schema validation information.
                if (book.PublicationDate != null)
                {
                    validator.ValidateAttribute("publicationdate", "", dateTimeGetter(book.PublicationDate), schemaInfo);
                }
                DisplaySchemaInfo();

                // Validate the ISBN attribute and display its post schema validation information.
                if (book.Isbn != null)
                {
                    validator.ValidateAttribute("ISBN", "", book.Isbn, schemaInfo);
                }
                DisplaySchemaInfo();

                // Verify that all required attributes of the book element are present
                // and prepare to validate child content.
                validator.ValidateEndOfAttributes(null);

                // Validate the title element and its content.
                validator.ValidateElement("title", "https://www.contoso.com/books", null);
                validator.ValidateEndElement(null, book.Title);

                // Validate the author element, verify that all required attributes are present
                // and prepare to validate child content.
                validator.ValidateElement("author", "https://www.contoso.com/books", null);
                validator.ValidateEndOfAttributes(null);

                if (book.Author.Name != null)
                {
                    // Validate the name element and its content.
                    validator.ValidateElement("name", "https://www.contoso.com/books", null);
                    validator.ValidateEndElement(null, book.Author.Name);
                }

                if (book.Author.FirstName != null)
                {
                    // Validate the first-name element and its content.
                    validator.ValidateElement("first-name", "https://www.contoso.com/books", null);
                    validator.ValidateEndElement(null, book.Author.FirstName);

                }

                if (book.Author.LastName != null)
                {
                    // Validate the last-name element and its content.
                    validator.ValidateElement("last-name", "https://www.contoso.com/books", null);
                    validator.ValidateEndElement(null, book.Author.LastName);
                }

                // Validate the content of the author element.
                validator.ValidateEndElement(null);

                // Validate the price element and its content.
                validator.ValidateElement("price", "https://www.contoso.com/books", null);
                validator.ValidateEndElement(null, book.Price);

                // Validate the content of the book element.
                validator.ValidateEndElement(null);
            }

            // Validate the content of the bookstore element.
            validator.ValidateEndElement(null);

            // Close the XmlReader object.
            reader.Close();
        }

        static XmlSchemaInfo schemaInfo = new XmlSchemaInfo();
        static object dateTimeGetterContent;

        static object dateTimeGetterHandle()
        {
            return dateTimeGetterContent;
        }

        static XmlValueGetter dateTimeGetter(DateTime dateTime)
        {
            dateTimeGetterContent = dateTime;
            return new XmlValueGetter(dateTimeGetterHandle);
        }

        static void DisplaySchemaInfo()
        {
            if (schemaInfo.SchemaElement != null)
            {
                Console.WriteLine("Element '{0}' with type '{1}' is '{2}'",
                    schemaInfo.SchemaElement.Name, schemaInfo.SchemaType, schemaInfo.Validity);
            }
            else if (schemaInfo.SchemaAttribute != null)
            {
                Console.WriteLine("Attribute '{0}' with type '{1}' is '{2}'",
                    schemaInfo.SchemaAttribute.Name, schemaInfo.SchemaType, schemaInfo.Validity);
            }
        }

        static void SchemaValidationEventHandler(object sender, ValidationEventArgs e)
        {
            switch (e.Severity)
            {
                case XmlSeverityType.Error:
                    Console.WriteLine("\nError: {0}", e.Message);
                    break;
                case XmlSeverityType.Warning:
                    Console.WriteLine("\nWarning: {0}", e.Message);
                    break;
            }
        }
    }

    [XmlRootAttribute("bookstore", Namespace = "https://www.contoso.com/books", IsNullable = false)]
    public class ContosoBooks
    {
        [XmlElementAttribute("book")]
        public BookType[] Book;
    }

    public class BookType
    {
        [XmlAttributeAttribute("genre")]
        public string Genre;

        [XmlAttributeAttribute("publicationdate", DataType = "date")]
        public DateTime PublicationDate;

        [XmlAttributeAttribute("ISBN")]
        public string Isbn;

        [XmlElementAttribute("title")]
        public string Title;

        [XmlElementAttribute("author")]
        public BookAuthor Author;

        [XmlElementAttribute("price")]
        public Decimal Price;
    }

    public class BookAuthor
    {
        [XmlElementAttribute("name")]
        public string Name;

        [XmlElementAttribute("first-name")]
        public string FirstName;

        [XmlElementAttribute("last-name")]
        public string LastName;
    }
}

이 예제에서는 contosoBooks.xml 파일을 입력으로 사용합니다.

<bookstore xmlns="https://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>

이 예제에서는 또한 contosoBooks.xsd를 입력으로 사용합니다.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" targetNamespace="https://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>

XmlSchemaValidator를 사용하여 XML 데이터의 유효성 검사

XML Infoset의 유효성 검사를 시작하려면 먼저 XmlSchemaValidator 생성자를 사용하여 XmlSchemaValidator 클래스의 새 인스턴스를 초기화해야 합니다.

XmlSchemaValidator 생성자는 XmlNameTable, XmlSchemaSet, XmlNamespaceManager 개체 및 XmlSchemaValidationFlags 값을 매개 변수로 사용합니다. XmlNameTable 개체는 스키마 네임스페이스, XML 네임스페이스 등의 잘 알려진 네임스페이스 문자열을 분해하는 데 사용되며 단순 내용의 유효성을 검사하는 동안 ParseValue 메서드에 전달됩니다. XmlSchemaSet 개체에는 XML Infoset의 유효성을 검사하는 데 사용되는 XML 스키마가 포함되어 있습니다. XmlNamespaceManager 개체를 사용하여 유효성 검사 중에 나타난 네임스페이스를 확인할 수 있습니다. XmlSchemaValidationFlags 값을 사용하여 특정 유효성 검사 기능을 비활성화할 수 있습니다.

XmlSchemaValidator 생성자에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

유효성 검사 초기화

XmlSchemaValidator 개체를 생성한 후 XmlSchemaValidator 개체 상태를 초기화하는 데 사용하는 오버로드된 Initialize 메서드 두 개가 있습니다. 다음은 이 두 Initialize 메서드입니다.

기본 XmlSchemaValidator.Initialize 메서드는 XmlSchemaValidator 개체를 시작 상태로 초기화하며 XmlSchemaObject를 매개 변수로 사용하는 오버로드된 XmlSchemaValidator.Initialize 메서드는 부분 유효성 검사를 위해 XmlSchemaValidator 개체를 시작 상태로 초기화합니다.

두 Initialize 메서드는 XmlSchemaValidator 개체를 생성하거나 EndValidation을 호출한 직후에만 호출할 수 있습니다.

XmlSchemaValidator.Initialize 메서드의 예제는 소개 단원의 예제를 참조하십시오. Initialize 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

부분 유효성 검사

XmlSchemaObject를 매개 변수로 사용하는 XmlSchemaValidator.Initialize 메서드는 부분 유효성 검사를 위해 XmlSchemaValidator 개체를 시작 상태로 초기화합니다.

다음 예제에서는 부분 유효성 검사를 위해 XmlSchemaValidator.Initialize 메서드를 사용하여 XmlSchemaObject를 초기화합니다. XmlSchemaSet 개체의 GlobalElements 속성이 반환하는 XmlSchemaObjectTable 컬렉션에서 XmlQualifiedName으로 스키마 요소를 선택하여 orderNumber 스키마 요소를 전달합니다. 그러면 XmlSchemaValidator 개체가 이 특정 요소의 유효성을 검사합니다.

Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()
schemaSet.Add(Nothing, "schema.xsd")
schemaSet.Compile()
Dim nameTable As NameTable = New NameTable()
Dim manager As XmlNamespaceManager = New XmlNamespaceManager(nameTable)

Dim validator As XmlSchemaValidator = New XmlSchemaValidator(nameTable, schemaSet, manager, XmlSchemaValidationFlags.None)
validator.Initialize(schemaSet.GlobalElements.Item(New XmlQualifiedName("orderNumber")))

validator.ValidateElement("orderNumber", "", Nothing)
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateText("123")
validator.ValidateEndElement(Nothing)

XmlSchemaSet schemaSet = new XmlSchemaSet();
schemaSet.Add(null, "schema.xsd");
schemaSet.Compile();
NameTable nameTable = new NameTable();
XmlNamespaceManager manager = new XmlNamespaceManager(nameTable);

XmlSchemaValidator validator = new XmlSchemaValidator(nameTable, schemaSet, manager, XmlSchemaValidationFlags.None);
validator.Initialize(schemaSet.GlobalElements[new XmlQualifiedName("orderNumber")]);

validator.ValidateElement("orderNumber", "", null);
validator.ValidateEndOfAttributes(null);
validator.ValidateText("123");
validator.ValidateEndElement(null);

이 예제에서는 다음 XML 스키마를 입력으로 사용합니다.

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">

<xs:element name="orderNumber" type="xs:int" />

</xs:schema>

Initialize 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

스키마 추가

XmlSchemaValidator 클래스의 AddSchema 메서드를 사용하면 유효성 검사 중에 사용되는 스키마 집합에 XML 스키마를 추가할 수 있습니다. AddSchema 메서드를 사용하여 유효성을 검사 중인 XML Infoset에서 인라인 XML 스키마가 나타난 결과를 시뮬레이트할 수 있습니다.

참고:
XmlSchema 매개 변수의 대상 네임스페이스는 이미 XmlSchemaValidator 개체에 발생한 요소나 특성의 대상 네임스페이스와 달라야 합니다. XmlSchemaValidationFlags.ProcessInlineSchema 값을 매개 변수로 XmlSchemaValidator 생성자에 전달하지 않은 경우 AddSchema 메서드는 아무 작업도 수행하지 않습니다.

XmlSchema 매개 변수의 대상 네임스페이스는 이미 XmlSchemaValidator 개체에 발생한 요소나 특성의 대상 네임스페이스와 달라야 합니다.

XmlSchemaValidationFlags.ProcessInlineSchema 값을 매개 변수로 XmlSchemaValidator 생성자에 전달하지 않은 경우 AddSchema 메서드는 아무 작업도 수행하지 않습니다.

AddSchema 메서드의 결과는 유효성을 검사 중인 현재 XML 노드 컨텍스트에 따라 다릅니다. 유효성 검사 컨텍스트에 대한 자세한 내용은 이 항목의 "유효성 검사 컨텍스트" 단원을 참조하십시오.

AddSchema 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

요소, 특성 및 내용 유효성 검사

XmlSchemaValidator 클래스는 XML Infoset에서 XML 스키마에 대해 요소, 특성 및 내용의 유효성을 검사할 수 있는 여러 메서드를 제공합니다. 다음 표에서는 이러한 메서드에 대해 설명합니다.

메서드	설명
ValidateElement	현재 컨텍스트에서 요소 이름의 유효성을 검사합니다.
ValidateAttribute	현재 요소 컨텍스트에서 또는 Initialize 메서드에 매개 변수로 전달된 XmlSchemaAttribute 개체에 대해 특성의 유효성을 검사합니다.
ValidateEndOfAttributes	요소 컨텍스트에 필수 특성이 모두 있는지 확인하고 XmlSchemaValidator 개체를 준비하여 요소의 자식 내용의 유효성을 검사합니다.
ValidateText	현재 요소 컨텍스트에서 텍스트가 허용되는지 확인하고 현재 요소에 단순 내용이 있는지 확인하기 위해 텍스트를 누적합니다.
ValidateWhitespace	현재 요소 컨텍스트에서 공백이 허용되는지 확인하고 현재 요소에 단순 내용이 있는지 확인하기 위해 공백을 누적합니다.
ValidateEndElement	단순 내용이 있는 요소의 데이터 형식에 따라 요소의 텍스트 내용이 유효한지 확인하고 현재 요소의 내용이 복합 내용이 있는 요소에 대해 완전한지 확인합니다.
SkipToEndElement	현재 요소 내용의 유효성 검사를 생략하고 XmlSchemaValidator 개체를 준비하여 부모 요소의 컨텍스트에서 내용의 유효성을 검사합니다.
EndValidation	ProcessIdentityConstraints 유효성 검사 옵션을 설정한 경우 유효성 검사를 종료하고 전체 XML 문서에 대한 identity 제약 조건을 확인합니다.

참고:
XmlSchemaValidator 클래스에는 앞의 표에서 설명한 각 메서드의 호출 시퀀스를 실행하고 호출을 발생시키는 상태 전환이 정의되어 있습니다. XmlSchemaValidator 클래스의 특정 상태 전환에 대한 자세한 내용은 이 항목의 "XmlSchemaValidator 상태 전환" 단원을 참조하십시오.

XML Infoset에서 요소, 특성 및 내용의 유효성을 검사하는 데 사용되는 메서드의 예는 이전 단원의 예제를 참조하십시오. 이러한 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

XmlValueGetter를 사용하여 내용 유효성 검사

XmlValueGetterdelegate를 사용하여 특성, 텍스트 또는 공백 노드의 값을 특성, 텍스트 또는 공백 노드의 XSD(XML 스키마 정의 언어) 형식과 호환되는 CLR(공용 언어 런타임) 형식으로 전달할 수 있습니다. 특성, 텍스트 또는 공백 노드의 CLR 값을 사용할 수 있는 경우 XmlValueGetterdelegate가 유용하며 string으로 변환하고 유효성을 검사하기 위해 다시 구문 분석하는 비용을 줄일 수 있습니다.

ValidateAttribute, ValidateText 및 ValidateWhitespace 메서드가 오버로드되며 특성, 텍스트 또는 공백 노드의 값을 string 또는 XmlValueGetterdelegate로 사용할 수 있도록 허용합니다.

XmlSchemaValidator 클래스의 다음 메서드에서는 XmlValueGetterdelegate를 매개 변수로 허용합니다.

다음은 소개 단원의 XmlSchemaValidator 클래스 예제에서 가져온 XmlValueGetterdelegate 예제입니다. XmlValueGetterdelegate는 특성 값을 DateTime 개체로 반환합니다. XmlValueGetter에서 반환된 이 DateTime 개체의 유효성을 검사하기 위해 XmlSchemaValidator 개체는 먼저 이 개체를 특성의 데이터 형식에 대한 ValueType으로 변환하고 변환된 값에서 패싯을 확인합니다. 여기서 ValueType은 XSD 형식에 대한 기본 CLR 매핑입니다.

Shared dateTimeGetterContent As Object

Shared Function dateTimeGetterHandle() As Object
    Return dateTimeGetterContent
End Function

Shared Function dateTimeGetter(ByVal dateTime As DateTime) As XmlValueGetter
    dateTimeGetterContent = dateTime
    Return New XmlValueGetter(AddressOf dateTimeGetterHandle)
End Function

static object dateTimeGetterContent;

static object dateTimeGetterHandle()
{
    return dateTimeGetterContent;
}

static XmlValueGetter dateTimeGetter(DateTime dateTime)
{
    dateTimeGetterContent = dateTime;
    return new XmlValueGetter(dateTimeGetterHandle);
}

XmlValueGetterdelegate의 전체 예제는 소개 단원의 예제를 참조하십시오. XmlValueGetterdelegate에 대한 자세한 내용은 XmlValueGetter 및 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

Post-Schema-Validation-Information

XmlSchemaInfo 클래스는 XmlSchemaValidator 클래스로 유효성을 검사하는 XML 노드의 Post-Schema-Validation-Information을 나타냅니다. XmlSchemaValidator 클래스의 다양한 메서드에서는 XmlSchemaInfo 개체를 선택적(null) out 매개 변수로 허용합니다.

유효성 검사를 성공적으로 마치면 유효성 검사 결과와 함께 XmlSchemaInfo 개체가 설정됩니다. 예를 들어, ValidateAttribute 메서드를 사용하여 특성의 유효성을 검사하면 유효성 검사 결과와 함께 XmlSchemaInfo 개체(지정한 경우)의 SchemaAttribute, SchemaType, MemberType 및 Validity 속성이 설정됩니다.

다음 XmlSchemaValidator 클래스 메서드에서는 XmlSchemaInfo 개체를 out 매개 변수로 허용합니다.

XmlSchemaInfo 클래스의 전체 예제는 소개 단원의 예제를 참조하십시오. XmlSchemaInfo 클래스에 대한 자세한 내용은 XmlSchemaInfo 클래스 참조 문서를 참조하십시오.

필요한 파티클, 특성 및 지정되지 않은 기본 특성 검색

XmlSchemaValidator 클래스는 현재 유효성 검사 컨텍스트에서 필요한 파티클, 특성 및 지정되지 않은 기본 특성을 검색하는 GetExpectedAttributes, GetExpectedParticles 및 GetUnspecifiedDefaultAttributes 메서드를 제공합니다.

필요한 파티클 검색

GetExpectedParticles 메서드는 현재 요소 컨텍스트에서 필요한 파티클이 포함된 XmlSchemaParticle 개체의 배열을 반환합니다. GetExpectedParticles 메서드가 반환할 수 있는 유효한 파티클은 XmlSchemaElement 및 XmlSchemaAny 클래스의 인스턴스입니다.

내용 모델의 compositor가 xs:sequence인 경우 시퀀스에서 다음 파티클만 반환됩니다. 내용 모델의 compositor가 xs:all 또는 xs:choice인 경우 현재 요소 컨텍스트에서 따를 수 있는 유효한 파티클이 모두 반환됩니다.

참고:
Initialize 메서드를 호출한 직후에 GetExpectedParticles 메서드를 호출할 경우 GetExpectedParticles 메서드는 모든 전역 요소를 반환합니다.

예를 들어, XSD(XML 스키마 정의 언어) 스키마 및 이 스키마를 따르는 XML 문서에서 book 요소의 유효성을 검사한 후에는 book 요소가 현재 요소 컨텍스트입니다. GetExpectedParticles 메서드는 title 요소를 나타내는 단일 XmlSchemaElement 개체가 포함된 배열을 반환합니다. 유효성 검사 컨텍스트가 title 요소인 경우 GetExpectedParticles 메서드는 빈 배열을 반환합니다. title 요소의 유효성을 검사한 후 description 요소의 유효성을 검사하기 전에 GetExpectedParticles 메서드를 호출하면 description 요소를 나타내는 단일 XmlSchemaElement 개체가 포함된 배열이 반환됩니다. description 요소의 유효성을 검사한 후 GetExpectedParticles 메서드를 호출하면 와일드카드를 나타내는 단일 XmlSchemaAny 개체가 포함된 배열이 반환됩니다.

Dim reader As XmlReader =  XmlReader.Create("input.xml") 

Dim schemaSet As XmlSchemaSet =  New XmlSchemaSet() 
schemaSet.Add(Nothing, "schema.xsd")
Dim manager As XmlNamespaceManager =  New XmlNamespaceManager(reader.NameTable) 

Dim validator As XmlSchemaValidator =  New XmlSchemaValidator(reader.NameTable,schemaSet,manager,XmlSchemaValidationFlags.None)
validator.Initialize()
 
validator.ValidateElement("book", "", Nothing)

validator.ValidateEndOfAttributes(Nothing)
For Each element As XmlSchemaElement In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
 
validator.ValidateElement("title", "", Nothing)
validator.ValidateEndOfAttributes(Nothing)
For Each element As XmlSchemaElement In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
validator.ValidateEndElement(Nothing)
 
For Each element As XmlSchemaElement In validator.GetExpectedParticles()
    Console.WriteLine(element.Name)
Next
 
validator.ValidateElement("description", "", Nothing)
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateEndElement(Nothing)
 
For Each particle As XmlSchemaParticle In validator.GetExpectedParticles()
    Console.WriteLine(particle.GetType())
Next
 
validator.ValidateElement("namespace", "", Nothing)
validator.ValidateEndOfAttributes(Nothing)
validator.ValidateEndElement(Nothing)
 
validator.ValidateEndElement(Nothing)

XmlReader reader = XmlReader.Create("input.xml");

XmlSchemaSet schemaSet = new XmlSchemaSet();
schemaSet.Add(null, "schema.xsd");
XmlNamespaceManager manager = new XmlNamespaceManager(reader.NameTable);

XmlSchemaValidator validator = new XmlSchemaValidator(reader.NameTable, schemaSet, manager, XmlSchemaValidationFlags.None);
validator.Initialize();

validator.ValidateElement("book", "", null);
            
validator.ValidateEndOfAttributes(null);
foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}

validator.ValidateElement("title", "", null);
validator.ValidateEndOfAttributes(null);
foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}
validator.ValidateEndElement(null);

foreach (XmlSchemaElement element in validator.GetExpectedParticles())
{
    Console.WriteLine(element.Name);
}

validator.ValidateElement("description", "", null);
validator.ValidateEndOfAttributes(null);
validator.ValidateEndElement(null);

foreach (XmlSchemaParticle particle in validator.GetExpectedParticles())
{
    Console.WriteLine(particle.GetType());
}

validator.ValidateElement("namespace", "", null);
validator.ValidateEndOfAttributes(null);
validator.ValidateEndElement(null);

validator.ValidateEndElement(null);

이 예제에서는 다음 XML을 입력으로 사용합니다.

<xs:schema xmlns:xs="http://www.w3c.org/2001/XMLSchema">

<xs:element name="book">

<xs:sequence>

<xs:element name="title" type="xs:string" />

<xs:element name="description" type="xs:string" />

<xs:any processContent="lax" maxOccurs="unbounded" />

</xs:sequence>

</xs:element>

</xs:schema>

이 예제에서는 다음 XSD 스키마를 입력으로 사용합니다.

<book>

<description>My Book's Description</description>

<namespace>System.Xml.Schema</namespace>

</book>

참고:
XmlSchemaValidator 클래스의 GetExpectedParticles, GetExpectedAttributes 및 AddSchema 메서드로 인한 결과는 유효성 검사가 실행 중인 현재 컨텍스트에 따라 달라집니다. 자세한 내용은 이 항목의 “유효성 검사 컨텍스트” 단원을 참조하십시오.

GetExpectedParticles 메서드의 예제는 소개 단원의 예제를 참조하십시오. GetExpectedParticles 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

필요한 특성 검색

GetExpectedAttributes 메서드는 현재 요소 컨텍스트에서 필요한 특성이 포함된 XmlSchemaAttribute 개체의 배열을 반환합니다.

예를 들어, 소개 단원의 예제에서는 GetExpectedAttributes 메서드를 사용하여 book 요소의 모든 특성을 검색합니다.

ValidateElement 메서드를 호출한 직후에 GetExpectedAttributes 메서드를 호출하면 XML 문서에 나타날 수 있는 모든 특성이 반환됩니다. 그러나 ValidateAttribute 메서드를 한 번 이상 호출한 후 GetExpectedAttributes 메서드를 호출하면 현재 요소에 대해 아직 유효성을 검사하지 않은 특성이 반환됩니다.

참고:
XmlSchemaValidator 클래스의 GetExpectedParticles, GetExpectedAttributes 및 AddSchema 메서드로 인한 결과는 유효성 검사가 실행 중인 현재 컨텍스트에 따라 달라집니다. 자세한 내용은 이 항목의 “유효성 검사 컨텍스트” 단원을 참조하십시오.

GetExpectedAttributes 메서드의 예제는 소개 단원의 예제를 참조하십시오. GetExpectedAttributes 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

지정되지 않은 기본 특성 검색

GetUnspecifiedDefaultAttributes 메서드는 요소 컨텍스트에서 ValidateAttribute 메서드를 사용하여 기본값의 유효성을 검사하지 않은 특성의 XmlSchemaAttribute 개체로 지정한 ArrayList를 채웁니다. 요소 컨텍스트의 각 특성에서 ValidateAttribute 메서드를 호출한 후에 GetUnspecifiedDefaultAttributes 메서드를 호출해야 합니다. 유효성을 검사 중인 XML 문서에 삽입할 기본 특성을 결정하려면 GetUnspecifiedDefaultAttributes 메서드를 사용해야 합니다.

GetUnspecifiedDefaultAttributes 메서드에 대한 자세한 내용은 XmlSchemaValidator 클래스 참조 문서를 참조하십시오.

스키마 유효성 검사 이벤트 처리

유효성을 검사하는 동안 발생한 스키마 유효성 검사 경고 및 오류는 XmlSchemaValidator 클래스의 ValidationEventHandler 이벤트로 처리됩니다.

스키마 유효성 검사 경고의 XmlSeverityType 값은 Warning이며 스키마 유효성 검사 오류의 XmlSeverityType 값은 Error입니다. ValidationEventHandler를 지정하지 않으면 XmlSeverityType 값이 Error인 모든 스키마 유효성 검사 오류에 대해 XmlSchemaValidationException이 throw됩니다. 그러나 XmlSeverityType 값이 Warning인 스키마 유효성 검사 경고에 대해서는 XmlSchemaValidationException이 throw되지 않습니다.

다음은 소개 단원의 예제에서 가져온 것으로, 스키마 유효성 검사 중에 발생한 스키마 유효성 검사 경고 및 오류를 받는 ValidationEventHandler의 예제입니다.

Shared Sub SchemaValidationEventHandler(ByVal sender As Object, ByVal e As ValidationEventArgs)

    Select Case e.Severity
        Case XmlSeverityType.Error
            Console.WriteLine(vbCrLf & "Error: {0}", e.Message)
            Exit Sub
        Case XmlSeverityType.Warning
            Console.WriteLine(vbCrLf & "Warning: {0}", e.Message)
            Exit Sub
    End Select
End Sub

static void SchemaValidationEventHandler(object sender, ValidationEventArgs e)
{
    switch (e.Severity)
    {
        case XmlSeverityType.Error:
            Console.WriteLine("\nError: {0}", e.Message);
            break;
        case XmlSeverityType.Warning:
            Console.WriteLine("\nWarning: {0}", e.Message);
            break;
    }
}

ValidationEventHandler의 전체 예제는 소개 단원의 예제를 참조하십시오. 자세한 내용은 XmlSchemaInfo 클래스 참조 문서를 참조하십시오.

XmlSchemaValidator 상태 전환

XmlSchemaValidator 클래스에는 XML Infoset에서 요소, 특성 및 내용의 유효성을 검사하는 데 사용되는 각 메서드의 호출 시퀀스를 실행하고 호출을 발생시키는 상태 전환이 정의되어 있습니다.

다음 표에서는 XmlSchemaValidator 클래스의 상태 전환 및 각 상태에서 수행할 수 있는 메서드 호출의 시퀀스와 발생에 대해 설명합니다.

상태	전환
Validate	Initialize (ValidateAttribute \| TopLevel*) EndValidation
TopLevel	ValidateWhitespace \| ValidateText \| Element
Element	ValidateElement ValidateAttribute* (ValidateEndOfAttributes Content)? ValidateEndElement \| ValidateElement ValidateAttribute SkipToEndElement \| ValidateElement ValidateAttribute* ValidateEndOfAttributes Content* SkipToEndElement \|
Content	ValidateWhitespace \| ValidateText \| Element

참고:
위 표에서 XmlSchemaValidator 개체의 현재 상태에 따라 잘못된 시퀀스에서 메서드를 호출하면 각 메서드에 의해 InvalidOperationException이 throw됩니다.

위의 상태 전환 표에서는 문장 부호를 사용하여 XmlSchemaValidator 클래스 상태 전환의 각 상태에 대해 호출할 수 있는 메서드와 기타 상태를 설명합니다. 사용된 문장 부호는 DTD(문서 종류 정의)에 대한 XML 표준 참조의 문장 부호와 같습니다.

다음 표에서는 위의 상태 전환 표에 나타난 문장 부호가 XmlSchemaValidator 클래스 상태 전환의 각 상태에 대해 호출할 수 있는 메서드와 기타 상태에 미치는 영향을 설명합니다.

기호	설명
\|	세로 막대 앞이나 뒤의 메서드 또는 상태를 호출할 수 있습니다.
?	물음표 앞의 메서드나 상태는 선택 항목이지만 이 메서드나 상태를 호출할 경우에는 한 번만 호출할 수 있습니다.
*	* 기호 앞의 메서드나 상태는 선택 항목이며 두 번 이상 호출할 수 있습니다.

유효성 검사 컨텍스트

XML Infoset에서 요소, 특성 및 내용의 유효성을 검사하는 데 사용하는 XmlSchemaValidator 클래스의 메서드는 XmlSchemaValidator 개체의 유효성 검사 컨텍스트를 변경합니다. 예를 들어, SkipToEndElement 메서드는 현재 요소 내용의 유효성 검사를 생략하고 XmlSchemaValidator 개체를 준비하여 부모 요소의 컨텍스트에서 내용의 유효성을 검사합니다. 이 동작은 현재 요소의 모든 자식에 대한 유효성 검사를 생략하고 ValidateEndElement 메서드를 호출하는 것과 같습니다.

XmlSchemaValidator 클래스의 GetExpectedParticles, GetExpectedAttributes 및 AddSchema 메서드로 인한 결과는 유효성 검사가 실행 중인 현재 컨텍스트에 따라 달라집니다.

이 표에서는 XML Infoset에서 요소, 특성 및 내용의 유효성을 검사하는 데 사용하는 XmlSchemaValidator 클래스의 메서드 중 하나를 호출한 후 이러한 메서드를 호출한 결과를 설명합니다.

메서드	GetExpectedParticles	GetExpectedAttributes	AddSchema
Initialize	기본 Initialize 메서드를 호출할 경우 GetExpectedParticles는 모든 전역 요소가 포함된 배열을 반환합니다. XmlSchemaObject를 매개 변수로 사용하는 오버로드된 Initialize 메서드를 호출하여 요소의 부분 유효성 검사를 초기화하는 경우 GetExpectedParticles는 XmlSchemaValidator 개체가 초기화된 요소만 반환합니다.	기본 Initialize 메서드를 호출할 경우 GetExpectedAttributes는 빈 배열을 반환합니다. XmlSchemaObject를 매개 변수로 사용하는 오버로드된 Initialize 메서드를 호출하여 특성의 부분 유효성 검사를 초기화하는 경우 GetExpectedAttributes는 XmlSchemaValidator 개체가 초기화된 특성만 반환합니다.	전처리 오류가 없을 경우 XmlSchemaValidator 개체의 XmlSchemaSet에 스키마를 추가합니다.
ValidateElement	컨텍스트 요소가 유효한 경우 GetExpectedParticles는 컨텍스트 요소 자식으로 필요한 요소의 시퀀스를 반환합니다. 컨텍스트 요소가 잘못되었으면 GetExpectedParticles가 빈 배열을 반환합니다.	컨텍스트 요소가 유효하고 이전에 ValidateAttribute를 호출하지 않은 경우 GetExpectedAttributes는 컨텍스트 요소에 정의된 모든 특성의 목록을 반환합니다. 일부 특성의 유효성을 이미 확인한 경우 GetExpectedAttributes는 유효성을 검사할 나머지 특성의 목록을 반환합니다. 컨텍스트 요소가 잘못되었으면 GetExpectedAttributes가 빈 배열을 반환합니다.	위와 동일합니다.
ValidateAttribute	컨텍스트 특성이 최상위 특성이면 GetExpectedParticles가 빈 배열을 반환합니다. 그렇지 않으면 GetExpectedParticles는 컨텍스트 요소의 첫 번째 자식으로 필요한 요소의 시퀀스를 반환합니다.	컨텍스트 특성이 최상위 특성이면 GetExpectedAttributes가 빈 배열을 반환합니다. 그렇지 않으면 GetExpectedAttributes는 유효성을 검사할 나머지 특성의 목록을 반환합니다.	위와 동일합니다.
GetUnspecifiedDefaultAttributes	GetExpectedParticles는 컨텍스트 요소의 첫 번째 자식으로 필요한 요소의 시퀀스를 반환합니다.	GetExpectedAttributes는 컨텍스트 요소에 대해 유효성을 검사할 필수 특성 및 선택적 특성의 목록을 반환합니다.	위와 동일합니다.
ValidateEndOfAttributes	GetExpectedParticles는 컨텍스트 요소의 첫 번째 자식으로 필요한 요소의 시퀀스를 반환합니다.	GetExpectedAttributes는 빈 배열을 반환합니다.	위와 동일합니다.
ValidateText	컨텍스트 요소의 contentType이 Mixed인 경우 GetExpectedParticles는 다음 위치에 필요한 요소의 시퀀스를 반환합니다. 컨텍스트 요소의 contentType이 TextOnly 또는 Empty인 경우 GetExpectedParticles는 빈 배열을 반환합니다. 컨텍스트 요소의 contentType이 ElementOnly인 경우 GetExpectedParticles는 다음 위치에 필요한 요소의 시퀀스를 반환하지만 유효성 검사 오류가 발생합니다.	GetExpectedAttributes는 특성의 유효성이 검사되지 않은 컨텍스트 요소의 목록을 반환합니다.	위와 동일합니다.
ValidateWhitespace	컨텍스트 공백이 최상위 공백이면 GetExpectedParticles가 빈 배열을 반환합니다. 그렇지 않으면 GetExpectedParticles 메서드의 동작이 ValidateText와 동일하게 됩니다.	컨텍스트 공백이 최상위 공백이면 GetExpectedAttributes가 빈 배열을 반환합니다. 그렇지 않으면 GetExpectedAttributes 메서드의 동작이 ValidateText와 동일하게 됩니다.	위와 동일합니다.
ValidateEndElement	GetExpectedParticles는 컨텍스트 요소(가능한 형제) 뒤에 필요한 요소의 시퀀스를 반환합니다.	GetExpectedAttributes는 특성의 유효성이 검사되지 않은 컨텍스트 요소의 목록을 반환합니다. 컨텍스트 요소에 부모가 없을 경우 GetExpectedAttributes는 빈 목록을 반환합니다. 컨텍스트 요소는 ValidateEndElement가 호출된 현재 요소의 부모입니다.	위와 동일합니다.
SkipToEndElement	ValidateEndElement와 동일합니다.	ValidateEndElement와 동일합니다.	위와 동일합니다.
EndValidation	빈 배열을 반환합니다.	빈 배열을 반환합니다.	위와 동일합니다.

참고:
XmlSchemaValidator 클래스의 다양한 속성이 반환하는 값은 위 표의 메서드를 호출해도 변경되지 않습니다.

참고 항목

참조

XmlSchemaValidator

다음을 통해 공유