XmlDocument.Validate 方法

参考

定义

命名空间:: System.Xml

程序集:: System.Xml.ReaderWriter.dll

程序集:: System.Xml.dll

程序集:: netstandard.dll

重要

一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。

验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。

重载

Validate(ValidationEventHandler)	验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。
Validate(ValidationEventHandler, XmlNode)	根据 Schemas 属性中的 XML 架构定义语言 (XSD) 架构，验证指定的 XmlNode 对象。

Validate(ValidationEventHandler)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

验证 XmlDocument 是不是 Schemas 属性中包含的 XML 架构定义语言 (XSD) 架构。

public:
 void Validate(System::Xml::Schema::ValidationEventHandler ^ validationEventHandler);

public void Validate (System.Xml.Schema.ValidationEventHandler? validationEventHandler);

public void Validate (System.Xml.Schema.ValidationEventHandler validationEventHandler);

member this.Validate : System.Xml.Schema.ValidationEventHandler -> unit

Public Sub Validate (validationEventHandler As ValidationEventHandler)

参数

validationEventHandler: ValidationEventHandler

接收有关架构验证警告和错误的信息的 ValidationEventHandler 对象。

例外

XmlSchemaValidationException

发生了架构验证事件并且没有指定任何 ValidationEventHandler 对象。

示例

下面的示例阐释了 Validate 方法的用法。该示例使用和对象创建XmlDocument包含关联的 XSD 架构的 XmlReaderSettings 。XmlReader 然后， XPathNavigator 该示例使用类错误地修改 XML 文档中元素的类型化值，从而生成架构验证错误。

#using <System.Xml.dll>

using namespace System;
using namespace System::Xml;
using namespace System::Xml::Schema;
using namespace System::Xml::XPath;

class XPathValidation
{
public:

    static void Main()
    {
        try
        {
            XmlReaderSettings^ settings = gcnew XmlReaderSettings();
            settings->Schemas->Add("http://www.contoso.com/books", "contosoBooks.xsd");
            settings->ValidationType = ValidationType::Schema;

            XmlReader^ reader = XmlReader::Create("contosoBooks.xml", settings);
            XmlDocument^ document = gcnew XmlDocument();
            document->Load(reader);

            ValidationEventHandler^ eventHandler = gcnew ValidationEventHandler(ValidationEventHandlerOne);

            // the following call to Validate succeeds.
            document->Validate(eventHandler);

            // add a node so that the document is no longer valid
            XPathNavigator^ navigator = document->CreateNavigator();
            navigator->MoveToFollowing("price", "http://www.contoso.com/books");
            XmlWriter^ writer = navigator->InsertAfter();
            writer->WriteStartElement("anotherNode", "http://www.contoso.com/books");
            writer->WriteEndElement();
            writer->Close();

            // the document will now fail to successfully validate
            document->Validate(eventHandler);
        }
        catch(Exception^ ex)
        {
            Console::WriteLine(ex->Message);
        }
    }

    static void ValidationEventHandlerOne(Object^ sender, ValidationEventArgs^ e)
    {
        switch (e->Severity)
        {
        case XmlSeverityType::Error:
            Console::WriteLine("Error: {0}", e->Message);
            break;
        case XmlSeverityType::Warning:
            Console::WriteLine("Warning {0}", e->Message);
            break;
        }

    }
};

int main()
{
    XPathValidation::Main();
    Console::ReadLine();
    return 0;
};

using System;
using System.Xml;
using System.Xml.Schema;
using System.Xml.XPath;

class XPathValidation
{
    static void Main()
    {
        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);

            ValidationEventHandler eventHandler = new ValidationEventHandler(ValidationEventHandler);

            // the following call to Validate succeeds.
            document.Validate(eventHandler);

            // add a node so that the document is no longer valid
            XPathNavigator navigator = document.CreateNavigator();
            navigator.MoveToFollowing("price", "http://www.contoso.com/books");
            XmlWriter writer = navigator.InsertAfter();
            writer.WriteStartElement("anotherNode", "http://www.contoso.com/books");
            writer.WriteEndElement();
            writer.Close();

            // the document will now fail to successfully validate
            document.Validate(eventHandler);
        }
        catch (Exception ex)
        {
            Console.WriteLine(ex.Message);
        }
    }

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

Imports System.Xml
Imports System.Xml.Schema
Imports System.Xml.XPath

Class XPathValidation

    Shared Sub Main()

        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 eventHandler As ValidationEventHandler = New ValidationEventHandler(AddressOf ValidationEventHandler)

            ' the following call to Validate succeeds.
            document.Validate(eventHandler)

            ' add a node so that the document is no longer valid
            Dim navigator As XPathNavigator = document.CreateNavigator()
            navigator.MoveToFollowing("price", "http://www.contoso.com/books")
            Dim writer As XmlWriter = navigator.InsertAfter()
            writer.WriteStartElement("anotherNode", "http://www.contoso.com/books")
            writer.WriteEndElement()
            writer.Close()

            ' the document will now fail to successfully validate
            document.Validate(eventHandler)

        Catch ex As Exception

            Console.WriteLine(ex.Message)

        End Try

    End Sub

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

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

    End Sub

End Class

该示例采用 contosoBooks.xml 和 contosoBooks.xsd 文件作为输入。

<?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>

<?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>

注解

方法Validate根据属性中包含的Schemas架构验证中的 XmlDocument XML 数据。方法 Validate 执行信息集扩充。具体而言，成功验证后，将应用架构默认值，根据需要将文本值转换为原子值，并且类型信息与已验证的信息项相关联。结果是中以前未类型化的 XML 子树 XmlDocument ，已替换为类型化子树。

以下是使用 Validate 方法时要考虑的重要注意事项。

架构位置提示（如 xsi:schemaLocation 或 xsi:noNamespaceSchemaLocation ）将被忽略。
将忽略内联架构。
如果在验证期间发生架构验证错误，则会 XmlDocument 使用某些具有正确类型信息的节点和没有的节点进行部分验证。
验证过程包括检查 (xs:ID、、xs:keyrefxs:IDREFxs:key、和 xs:unique) 的唯一性和引用约束。

适用于

Validate(ValidationEventHandler, XmlNode)

Source:: XmlDocument.cs

Source:: XmlDocument.cs

Source:: XmlDocument.cs

根据 Schemas 属性中的 XML 架构定义语言 (XSD) 架构，验证指定的 XmlNode 对象。

public:
 void Validate(System::Xml::Schema::ValidationEventHandler ^ validationEventHandler, System::Xml::XmlNode ^ nodeToValidate);

public void Validate (System.Xml.Schema.ValidationEventHandler? validationEventHandler, System.Xml.XmlNode nodeToValidate);

public void Validate (System.Xml.Schema.ValidationEventHandler validationEventHandler, System.Xml.XmlNode nodeToValidate);

member this.Validate : System.Xml.Schema.ValidationEventHandler * System.Xml.XmlNode -> unit

Public Sub Validate (validationEventHandler As ValidationEventHandler, nodeToValidate As XmlNode)

参数

validationEventHandler: ValidationEventHandler

接收有关架构验证警告和错误的信息的 ValidationEventHandler 对象。

nodeToValidate: XmlNode

从 XmlDocument 创建的要验证的 XmlNode 对象。

例外

ArgumentException

XmlNode 对象参数不是从 XmlDocument 创建的。

InvalidOperationException

XmlNode 对象参数不是元素、特性、文档片段或根节点。

XmlSchemaValidationException

发生了架构验证事件并且没有指定任何 ValidationEventHandler 对象。

示例

有关方法的示例 Validate ，请参阅 Validate 方法。

注解

方法Validate根据属性中包含的Schemas架构验证对象中的 XmlNode XML 数据。方法 Validate 执行信息集扩充。具体而言，成功验证后，将应用架构默认值，根据需要将文本值转换为原子值，并且类型信息与已验证的信息项相关联。结果是中以前未类型化的 XML 子树 XmlDocument ，已替换为类型化子树。

以下是使用 Validate 方法时要考虑的重要注意事项。

架构位置提示（如 xsi:schemaLocation 或 xsi:noNamespaceSchemaLocation ）将被忽略。
将忽略内联架构。
如果在验证期间发生架构验证错误，则会 XmlDocument 使用某些具有正确类型信息的节点和没有的节点进行部分验证。

如果要验证的节点是根节点，则验证过程包括检查唯一性和引用约束 (xs:ID、xs:IDREF、xs:keyxs:keyref、和 xs:unique) ;否则，将省略唯一性和引用约束。

适用于

通过

XmlDocument.Validate 方法

定义

重载

Validate(ValidationEventHandler)

参数

例外

示例

注解

适用于

Validate(ValidationEventHandler, XmlNode)

参数

例外

示例

注解

适用于

其他资源