Extensions.Validate Método

Definição

Valida se um XDocument, um XElement ou um XAttribute está em conformidade com um XSD em um XmlSchemaSet.

Sobrecargas

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Esse método valida se um XDocument está em conformidade com um XSD em um XmlSchemaSet.

Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Esse método valida que um XAttribute está em conformidade com um XmlSchemaObject e um XmlSchemaSet especificados.

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida que um XDocument está em conformidade com um XSD em um XmlSchemaSet, opcionalmente, preenchendo a árvore XML com o PSVI (post-schema-validation infoset).

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Esse método valida que uma subárvore XElement está em conformidade com um XmlSchemaObject e um XmlSchemaSet especificados.

Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida se um XAttribute está em conformidade com um XmlSchemaObject e XmlSchemaSet especificados, opcionalmente, populando a árvore XML com o PSVI (infoset de validação pós-esquema).

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Valida se uma subárvore XElement está em conformidade com um XmlSchemaObject e XmlSchemaSet especificados, opcionalmente, populando a árvore XML com o PSVI (infoset de validação pós-esquema).

Comentários

Esses métodos usam um subjacente XmlReader para validar a árvore XML em relação a um XSD.

Mensagens de erro e aviso de validação são tratadas usando o ValidationEventHandler delegado . Se nenhum manipulador de eventos for fornecido a esses métodos, os erros de validação serão expostos como um XmlSchemaValidationException. Os avisos de validação não fazem com que um XmlSchemaValidationException seja gerado.

Alguns desses métodos de extensão opcionalmente permitem a população do PSVI (conjunto de informações pós-validação de esquema).

Validate(XDocument, XmlSchemaSet, ValidationEventHandler)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Esse método valida se um XDocument está em conformidade com um XSD em um XmlSchemaSet.

public static void Validate (this System.Xml.Linq.XDocument source, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler);
public static void Validate (this System.Xml.Linq.XDocument source, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler);

Parâmetros

source
XDocument

O XDocument a ser validado.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

O exemplo a seguir cria um XmlSchemaSet e, em seguida, valida dois objetos XDocument no conjunto de esquemas. Um dos documentos é válido, o outro não.

                string xsdMarkup =  
    @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:sequence>  
          <xsd:element name='Child1' minOccurs='1' maxOccurs='1'/>  
          <xsd:element name='Child2' minOccurs='1' maxOccurs='1'/>  
         </xsd:sequence>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  
XmlSchemaSet schemas = new XmlSchemaSet();  
schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

XDocument doc1 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "content1"),  
        new XElement("Child2", "content1")  
    )  
);  

XDocument doc2 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "content1"),  
        new XElement("Child3", "content1")  
    )  
);  

Console.WriteLine("Validating doc1");  
bool errors = false;  
doc1.Validate(schemas, (o, e) =>  
                     {  
                         Console.WriteLine("{0}", e.Message);  
                         errors = true;  
                     });  
Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Validating doc2");  
errors = false;  
doc2.Validate(schemas, (o, e) =>  
                     {  
                         Console.WriteLine("{0}", e.Message);  
                         errors = true;  
                     });  
Console.WriteLine("doc2 {0}", errors ? "did not validate" : "validated");  

Esse exemplo gera a saída a seguir:

Validating doc1  
doc1 validated  

Validating doc2  
The element 'Root' has invalid child element 'Child3'. List of possible elements expected: 'Child2'.  
doc2 did not validate  

Comentários

Esse método de extensão valida que o XDocument está em conformidade com o modelo de conteúdo de esquema em XmlSchemaSet.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Esse método valida que um XAttribute está em conformidade com um XmlSchemaObject e um XmlSchemaSet especificados.

public static void Validate (this System.Xml.Linq.XAttribute source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler);
public static void Validate (this System.Xml.Linq.XAttribute source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler);

Parâmetros

source
XAttribute

O XAttribute a ser validado.

partialValidationType
XmlSchemaObject

Um XmlSchemaObject que especifica a subárvore a ser validada.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

                string xsdMarkup =  
    @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:simpleContent>  
          <xsd:extension base='xsd:string'>  
           <xsd:attribute name='Lang' use='required'>  
            <xsd:simpleType>  
             <xsd:restriction base='xsd:token'>  
              <xsd:enumeration value='C#'/>  
              <xsd:enumeration value='VB'/>  
             </xsd:restriction>  
            </xsd:simpleType>  
           </xsd:attribute>  
          </xsd:extension>  
         </xsd:simpleContent>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  

XmlSchemaSet schemas = new XmlSchemaSet();  
schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

XDocument doc1 = new XDocument(  
    new XElement("Root",  
        new XAttribute("Lang", "C#")  
    )  
);  

Console.WriteLine("Validating doc1 ...");  
bool errors = false;  
doc1.Validate(schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    }, true);  
Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Validating Lang attribute ...");  
XAttribute lang = doc1.Root.Attribute("Lang");  

errors = false;  
lang.Validate(lang.GetSchemaInfo().SchemaAttribute, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    });  
Console.WriteLine("lang {0}", errors ? "did not validate" : "validated");  

// the following makes the Lang attribute invalid according to the schema  
lang.Value = "VC";  

Console.WriteLine();  
Console.WriteLine("Validating Lang attribute ...");  

errors = false;  
lang.Validate(lang.GetSchemaInfo().SchemaAttribute, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    });  
Console.WriteLine("lang {0}", errors ? "did not validate" : "validated");  

Esse exemplo gera a saída a seguir:

Validating doc1 ...  
doc1 validated  

Validating Lang attribute ...  
lang validated  

Validating Lang attribute ...  
The 'Lang' attribute is invalid - The value 'VC' is invalid according to its datatype 'Token' - The Enumeration constraint failed.  
lang did not validate  

Comentários

Você pode usar esse método para validar se um XAttribute está em conformidade com um esquema. Normalmente, você usa esse método quando modifica um atributo e deseja garantir que ele ainda esteja em conformidade com seu esquema. Você pode validar todo o documento, mas leva menos tempo de processamento para validar apenas o atributo.

Se você passar null para validationEventHandler, esse método gerará uma exceção após erros de validação. Os avisos de validação não gerarão uma exceção.

Para validar um atributo, use uma instância do XmlSchemaObject. Você pode obter essa instância de várias maneiras. Uma maneira fácil é a seguinte:

  1. Valide se um documento está em conformidade com um esquema.

  2. Adicione o PSVI (conjunto de informações pós-validação de esquema) chamando o Validate método de extensão.

  3. Chame o GetSchemaInfo método de extensão para recuperar um objeto que implementa IXmlSchemaInfo. No objeto recuperado, você pode obter um XmlSchemaObject.

Depois de ter uma instância de um XmlSchemaObject, você pode usar esse método para validar um atributo.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Validate(XDocument, XmlSchemaSet, ValidationEventHandler, Boolean)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Valida que um XDocument está em conformidade com um XSD em um XmlSchemaSet, opcionalmente, preenchendo a árvore XML com o PSVI (post-schema-validation infoset).

public static void Validate (this System.Xml.Linq.XDocument source, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler, bool addSchemaInfo);
public static void Validate (this System.Xml.Linq.XDocument source, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler, bool addSchemaInfo);

Parâmetros

source
XDocument

O XDocument a ser validado.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

addSchemaInfo
Boolean

Um Boolean indicando se deve popular o PSVI (post-schema-validation infoset).

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

O exemplo a seguir contém um XSD que define o Child2 elemento com um Att1 atributo com um valor padrão. Depois de validar o documento com êxito, o atributo com o valor padrão é adicionado à árvore XML. Observe que o atributo padrão não é adicionado a doc2, que não é validado em relação ao esquema.

                string xsdMarkup =  
    @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:sequence>  
          <xsd:element name='Child1' minOccurs='1' maxOccurs='1'/>  
          <xsd:element name='Child2' minOccurs='1' maxOccurs='1'>  
           <xsd:complexType>  
            <xsd:simpleContent>  
             <xsd:extension base='xsd:string'>  
              <xsd:attribute name='Att1' default='Att1 Default Value'/>  
             </xsd:extension>  
            </xsd:simpleContent>  
           </xsd:complexType>  
          </xsd:element>  
         </xsd:sequence>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  
XmlSchemaSet schemas = new XmlSchemaSet();  
schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

XDocument doc1 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "c1"),  
        new XElement("Child2", "c2")  
    )  
);  

XDocument doc2 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "content1"),  
        new XElement("Child3", "content1")  
    )  
);  

Console.WriteLine("Validating doc1");  
bool errors = false;  
doc1.Validate(schemas, (o, e) =>  
                           {  
                               Console.WriteLine("{0}", e.Message);  
                               errors = true;  
                           }, true);  
Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Validating doc2");  
errors = false;  
doc2.Validate(schemas, (o, e) =>  
                     {  
                         Console.WriteLine("{0}", e.Message);  
                         errors = true;  
                     }, true);  
Console.WriteLine("doc2 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Contents of doc1:");  
Console.WriteLine(doc1);  

Console.WriteLine();  
Console.WriteLine("Contents of doc2:");  
Console.WriteLine(doc2);  

Esse exemplo gera a saída a seguir:

Validating doc1  
doc1 validated  

Validating doc2  
The element 'Root' has invalid child element 'Child3'. List of possible elements expected: 'Child2'.  
doc2 did not validate  

Contents of doc1:  
<Root>  
  <Child1>c1</Child1>  
  <Child2 Att1="Att1 Default Value">c2</Child2>  
</Root>  

Contents of doc2:  
<Root>  
  <Child1>content1</Child1>  
  <Child3>content1</Child3>  
</Root>  

O exemplo a seguir preenche a árvore com PSVI. Após a validação, ele imprime todos os elementos e atributos na árvore que são inválidos de acordo com o PSVI.

                static void DumpInvalidNodes(XElement el)  
{  
    if (el.GetSchemaInfo().Validity != XmlSchemaValidity.Valid)  
        Console.WriteLine("Invalid Element {0}",  
            el.AncestorsAndSelf()  
            .InDocumentOrder()  
            .Aggregate("", (s, i) => s + "/" + i.Name.ToString()));  
    foreach (XAttribute att in el.Attributes())  
        if (att.GetSchemaInfo().Validity != XmlSchemaValidity.Valid)  
            Console.WriteLine("Invalid Attribute {0}",  
                att  
                .Parent  
                .AncestorsAndSelf()  
                .InDocumentOrder()  
                .Aggregate("",  
                    (s, i) => s + "/" + i.Name.ToString()) + "/@" + att.Name.ToString()  
                );  
    foreach (XElement child in el.Elements())  
        DumpInvalidNodes(child);  
}  

static void Main(string[] args)  
{  
   string xsdMarkup =  
        @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
           <xsd:simpleType name='GCType'>  
            <xsd:restriction base='xsd:token'>  
             <xsd:enumeration value='AAA'/>  
             <xsd:enumeration value='BBB'/>  
            </xsd:restriction>  
           </xsd:simpleType>  
           <xsd:element name='Root'>  
            <xsd:complexType>  
             <xsd:sequence>  
              <xsd:element name='Child1' minOccurs='1' maxOccurs='1'>  
               <xsd:complexType>  
                <xsd:sequence>  
                 <xsd:element name='GrandChild1' type='GCType'/>  
                 <xsd:element name='GrandChild2' type='GCType'/>  
                 <xsd:element name='GrandChild3' type='GCType'/>  
                </xsd:sequence>  
               </xsd:complexType>  
              </xsd:element>  
             </xsd:sequence>  
            </xsd:complexType>  
           </xsd:element>  
          </xsd:schema>";  

    XmlSchemaSet schemas = new XmlSchemaSet();  
    schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

    XDocument doc1 = new XDocument(  
        new XElement("Root",  
            new XElement("Child1",  
                new XElement("GrandChild1", "AAA"),  
                new XElement("GrandChild2", "ZZZ"),  
                new XElement("GrandChild3", "ZZZ")  
            )  
        )  
    );  

    Console.WriteLine("Validating doc1 ...");  
    bool errors = false;  
    doc1.Validate(schemas, (sender, e) =>  
        {  
            Console.WriteLine(e.Message);  
            errors = true;  
        }, true);  
    Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  
    DumpInvalidNodes(doc1.Root);  
}  

Esse exemplo gera a saída a seguir:

Validating doc1 ...  
The 'GrandChild2' element is invalid - The value 'ZZZ' is invalid according to its datatype 'GCType' - The Enumeration constraint failed.  
The 'GrandChild3' element is invalid - The value 'ZZZ' is invalid according to its datatype 'GCType' - The Enumeration constraint failed.  
doc1 did not validate  
Invalid Element /Root  
Invalid Element /Root/Child1  
Invalid Element /Root/Child1/GrandChild2  
Invalid Element /Root/Child1/GrandChild3  

Comentários

Esse método de extensão valida que o XDocument está em conformidade com o modelo de conteúdo de esquema em XmlSchemaSet.

Se addSchemaInfo for true, esse método preencherá a árvore XML com o PSVI (conjunto de informações pós-validação de esquema).

Há duas etapas para preencher a árvore XML com o PSVI.

  1. Primeiro, uma anotação é adicionada a todos os nós na árvore para permitir que você chame Extensions.GetSchemaInfo ou Extensions.GetSchemaInfo em um elemento ou atributo na árvore.

  2. Em segundo lugar, os elementos e atributos padrão definidos no XSD são adicionados à árvore XML. Ao chamar um dos GetSchemaInfo métodos, você pode determinar se um elemento ou atributo específico foi adicionado do XSD como um elemento ou atributo padrão.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Esse método valida que uma subárvore XElement está em conformidade com um XmlSchemaObject e um XmlSchemaSet especificados.

public static void Validate (this System.Xml.Linq.XElement source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler);
public static void Validate (this System.Xml.Linq.XElement source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler);

Parâmetros

source
XElement

O XElement a ser validado.

partialValidationType
XmlSchemaObject

Um XmlSchemaObject que especifica a subárvore a ser validada.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

                string xsdMarkup =  
    @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:sequence>  
          <xsd:element name='Child1' minOccurs='1' maxOccurs='1'>  
           <xsd:complexType>  
            <xsd:sequence>  
             <xsd:element name='GrandChild1' minOccurs='1' maxOccurs='1'/>  
             <xsd:element name='GrandChild2' minOccurs='1' maxOccurs='2'/>  
            </xsd:sequence>  
           </xsd:complexType>  
          </xsd:element>  
         </xsd:sequence>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  

XmlSchemaSet schemas = new XmlSchemaSet();  
schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

XDocument doc1 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1",  
            new XElement("GrandChild1", "gc"),  
            new XElement("GrandChild2", "gc")  
        )  
    )  
);  

Console.WriteLine("Validating doc1 ...");  
bool errors = false;  
doc1.Validate(schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    }, true);  
Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Validating Child1 after first edit ...");  
XElement child1 = doc1.Element("Root").Element("Child1");  
child1.Add(new XElement("GrandChild2", "gc"));  
errors = false;  
child1.Validate(child1.GetSchemaInfo().SchemaElement, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    });  
Console.WriteLine("child1 {0}", errors ? "did not validate" : "validated");  

// the following makes the Child1 element invalid according to the schema  
child1.Add(new XElement("GrandChild3", "gc"));  
Console.WriteLine();  
Console.WriteLine("Validating Child1 after second edit ...");  
child1.Validate(child1.GetSchemaInfo().SchemaElement, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    });  
Console.WriteLine("child1 {0}", errors ? "did not validate" : "validated");  

Esse exemplo gera a saída a seguir:

Validating doc1 ...  
doc1 validated  

Validating Child1 after first edit ...  
child1 validated  

Validating Child1 after second edit ...  
The element 'Child1' has invalid child element 'GrandChild3'.  
child1 did not validate  

Comentários

Você pode usar esse método para validar se uma subárvore (com uma XElement em sua raiz) está em conformidade com um esquema. Normalmente, você usa esse método quando modifica uma subárvore e deseja garantir que ele ainda esteja em conformidade com seu esquema. Você pode validar todo o documento, mas leva menos tempo de processamento para validar apenas uma subárvore.

Se você passar null para validationEventHandler, esse método gerará uma exceção após erros de validação. Os avisos de validação não gerarão uma exceção.

Para validar uma subárvore, use uma instância do XmlSchemaObject. Você pode obter essa instância de várias maneiras. Uma maneira fácil é a seguinte:

  1. Valide se um documento está em conformidade com um esquema.

  2. Adicione o PSVI (conjunto de informações pós-validação de esquema) chamando o Validate método de extensão.

  3. Chame o GetSchemaInfo método de extensão para recuperar um objeto que implementa IXmlSchemaInfo. No objeto recuperado, você pode obter um XmlSchemaObject.

Depois de ter uma instância de um XmlSchemaObject, você pode usar esse método para validar uma subárvore.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Validate(XAttribute, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Valida se um XAttribute está em conformidade com um XmlSchemaObject e XmlSchemaSet especificados, opcionalmente, populando a árvore XML com o PSVI (infoset de validação pós-esquema).

public static void Validate (this System.Xml.Linq.XAttribute source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler, bool addSchemaInfo);
public static void Validate (this System.Xml.Linq.XAttribute source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler, bool addSchemaInfo);

Parâmetros

source
XAttribute

O XAttribute a ser validado.

partialValidationType
XmlSchemaObject

Um XmlSchemaObject que especifica a subárvore a ser validada.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

addSchemaInfo
Boolean

Um Boolean indicando se deve popular o PSVI (post-schema-validation infoset).

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

                static void DumpInvalidNodes(XElement el)  
{  
    if (el.GetSchemaInfo().Validity != XmlSchemaValidity.Valid)  
        Console.WriteLine("Invalid Element {0}",  
            el.AncestorsAndSelf()  
            .InDocumentOrder()  
            .Aggregate("", (s, i) => s + "/" + i.Name.ToString()));  
    foreach (XAttribute att in el.Attributes())  
        if (att.GetSchemaInfo().Validity != XmlSchemaValidity.Valid)  
            Console.WriteLine("Invalid Attribute {0}",  
                att  
                .Parent  
                .AncestorsAndSelf()  
                .InDocumentOrder()  
                .Aggregate("",  
                    (s, i) => s + "/" + i.Name.ToString()) + "/@" + att.Name.ToString()  
                );  
    foreach (XElement child in el.Elements())  
        DumpInvalidNodes(child);  
}  

static void Main(string[] args)  
{  
    string xsdMarkup =  
        @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:simpleContent>  
          <xsd:extension base='xsd:string'>  
           <xsd:attribute name='Lang' use='required'>  
            <xsd:simpleType>  
             <xsd:restriction base='xsd:token'>  
              <xsd:enumeration value='C#'/>  
              <xsd:enumeration value='VB'/>  
             </xsd:restriction>  
            </xsd:simpleType>  
           </xsd:attribute>  
          </xsd:extension>  
         </xsd:simpleContent>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  

    XmlSchemaSet schemas = new XmlSchemaSet();  
    schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

    XDocument doc1 = new XDocument(  
        new XElement("Root",  
            new XAttribute("Lang", "C#")  
        )  
    );  

    Console.WriteLine("Validating doc1 ...");  
    bool errors = false;  
    doc1.Validate(schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    }, true);  
    Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  
    DumpInvalidNodes(doc1.Root);  

    Console.WriteLine();  
    Console.WriteLine("Validating Lang attribute ...");  
    XAttribute lang = doc1.Element("Root").Attribute("Lang");  

    errors = false;  
    lang.Validate(lang.GetSchemaInfo().SchemaAttribute, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    }, true);  
    Console.WriteLine("lang {0}", errors ? "did not validate" : "validated");  
    DumpInvalidNodes(doc1.Root);  

    // the following makes the Lang attribute invalid according to the schema  
    lang.Value = "VC";  

    Console.WriteLine();  
    Console.WriteLine("Validating Lang attribute ...");  

    errors = false;  
    lang.Validate(lang.GetSchemaInfo().SchemaAttribute, schemas, (sender, e) =>  
    {  
        Console.WriteLine(e.Message);  
        errors = true;  
    }, true);  
    Console.WriteLine("lang {0}", errors ? "did not validate" : "validated");  
    DumpInvalidNodes(doc1.Root);  
}  

Esse exemplo gera a saída a seguir:

Validating doc1 ...  
doc1 validated  

Validating Lang attribute ...  
lang validated  

Validating Lang attribute ...  
The 'Lang' attribute is invalid - The value 'VC' is invalid according to its datatype 'Token' - The Enumeration constraint failed.  
lang did not validate  
Invalid Attribute /Root/@Lang  

Comentários

Você pode usar esse método para validar se um XAttribute está em conformidade com um esquema. Normalmente, você usa esse método quando modifica um atributo e deseja garantir que ele ainda esteja em conformidade com seu esquema. Você pode validar todo o documento, mas leva menos tempo de processamento para validar apenas o atributo.

Se addSchemaInfo for true, esse método preencherá o atributo com o PSVI (conjunto de informações de validação pós-esquema). Depois de preencher a árvore XML com o PSVI, você pode chamar Extensions.GetSchemaInfo no atributo validado. Isso será útil se você estiver escrevendo um código que dependa de dados retornados por GetSchemaInfo.

Se você passar null para validationEventHandler, esse método gerará uma exceção após erros de validação. Os avisos de validação não gerarão uma exceção.

Para validar um atributo, use uma instância do XmlSchemaObject. Você pode obter essa instância de várias maneiras. Uma maneira fácil é a seguinte:

  1. Valide se um documento está em conformidade com um esquema.

  2. Adicione o PSVI (conjunto de informações pós-validação de esquema) chamando o método de Validate extensão.

  3. Chame o GetSchemaInfo método de extensão para recuperar um objeto que implementa IXmlSchemaInfo. No objeto recuperado, você pode obter um XmlSchemaObject.

Depois de ter uma instância de um XmlSchemaObject, você pode usar esse método para validar um atributo.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1

Validate(XElement, XmlSchemaObject, XmlSchemaSet, ValidationEventHandler, Boolean)

Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs
Origem:
XNodeValidator.cs

Valida se uma subárvore XElement está em conformidade com um XmlSchemaObject e XmlSchemaSet especificados, opcionalmente, populando a árvore XML com o PSVI (infoset de validação pós-esquema).

public static void Validate (this System.Xml.Linq.XElement source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler? validationEventHandler, bool addSchemaInfo);
public static void Validate (this System.Xml.Linq.XElement source, System.Xml.Schema.XmlSchemaObject partialValidationType, System.Xml.Schema.XmlSchemaSet schemas, System.Xml.Schema.ValidationEventHandler validationEventHandler, bool addSchemaInfo);

Parâmetros

source
XElement

O XElement a ser validado.

partialValidationType
XmlSchemaObject

Um XmlSchemaObject que especifica a subárvore a ser validada.

schemas
XmlSchemaSet

Um XmlSchemaSet em relação ao qual validar.

validationEventHandler
ValidationEventHandler

Um ValidationEventHandler para um evento que ocorre quando o leitor encontra erros de validação. Se null, gera uma exceção nos erros de validação.

addSchemaInfo
Boolean

Um Boolean indicando se deve popular o PSVI (post-schema-validation infoset).

Exceções

Gerado para erros de validação de XSD (linguagem de definição de esquema XML).

Exemplos

                string xsdMarkup =  
    @"<xsd:schema xmlns:xsd='http://www.w3.org/2001/XMLSchema'>  
       <xsd:element name='Root'>  
        <xsd:complexType>  
         <xsd:sequence>  
          <xsd:element name='Child1' minOccurs='1' maxOccurs='1'/>  
          <xsd:element name='Child2' minOccurs='1' maxOccurs='1'>  
           <xsd:complexType>  
            <xsd:simpleContent>  
             <xsd:extension base='xsd:string'>  
              <xsd:attribute name='Att1' default='Att1 Default Value'/>  
             </xsd:extension>  
            </xsd:simpleContent>  
           </xsd:complexType>  
          </xsd:element>  
         </xsd:sequence>  
        </xsd:complexType>  
       </xsd:element>  
      </xsd:schema>";  
XmlSchemaSet schemas = new XmlSchemaSet();  
schemas.Add("", XmlReader.Create(new StringReader(xsdMarkup)));  

XDocument doc1 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "c1"),  
        new XElement("Child2", "c2")  
    )  
);  

XDocument doc2 = new XDocument(  
    new XElement("Root",  
        new XElement("Child1", "content1"),  
        new XElement("Child3", "content1")  
    )  
);  

Console.WriteLine("Validating doc1");  
bool errors = false;  
doc1.Validate(schemas, (o, e) =>  
                     {  
                         Console.WriteLine("{0}", e.Message);  
                         errors = true;  
                     }, true);  
Console.WriteLine("doc1 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Validating doc2");  
errors = false;  
doc2.Validate(schemas, (o, e) =>  
                     {  
                         Console.WriteLine("{0}", e.Message);  
                         errors = true;  
                     }, true);  
Console.WriteLine("doc2 {0}", errors ? "did not validate" : "validated");  

Console.WriteLine();  
Console.WriteLine("Contents of doc1:");  
Console.WriteLine(doc1);  

Console.WriteLine();  
Console.WriteLine("Contents of doc2:");  
Console.WriteLine(doc2);  

Esse exemplo gera a saída a seguir:

Validating doc1  
doc1 validated  

Validating doc2  
The element 'Root' has invalid child element 'Child3'. List of possible elements expected: 'Child2'.  
doc2 did not validate  

Contents of doc1:  
<Root>  
  <Child1>c1</Child1>  
  <Child2 Att1="Att1 Default Value">c2</Child2>  
</Root>  

Contents of doc2:  
<Root>  
  <Child1>content1</Child1>  
  <Child3>content1</Child3>  
</Root>  

Comentários

Você pode usar esse método para validar se uma subárvore (com uma XElement na raiz da subárvore) está em conformidade com um esquema. Normalmente, você usa esse método quando modifica uma subárvore e deseja garantir que ele ainda esteja em conformidade com seu esquema. Você pode validar todo o documento, mas leva menos tempo de processamento para validar apenas uma subárvore.

Se addSchemaInfo for true, esse método preencherá a árvore XML com o PSVI (conjunto de informações de validação pós-esquema).

Há dois aspectos do preenchimento da árvore XML com o PSVI.

Primeiro, uma anotação é adicionada a todos os nós na árvore, de modo que agora você pode chamar GetSchemaInfo em um elemento ou atributo na árvore.

Em segundo lugar, os elementos e atributos padrão definidos no XSD são adicionados à árvore XML. Ao chamar um dos GetSchemaInfo métodos, você pode determinar se um elemento ou atributo específico foi adicionado do XSD como um elemento ou atributo padrão.

Se você passar null para validationEventHandler, esse método gerará uma exceção após erros de validação. Os avisos de validação não gerarão uma exceção.

Para validar uma subárvore, use uma instância do XmlSchemaObject. Você pode obter essa instância de várias maneiras. Uma maneira fácil é a seguinte:

  1. Valide se um documento está em conformidade com um esquema.

  2. Adicione o PSVI (conjunto de informações pós-validação de esquema) chamando o método de Validate extensão.

  3. Chame o GetSchemaInfo método de extensão para recuperar um objeto que implementa IXmlSchemaInfo. No objeto recuperado, você pode obter um XmlSchemaObject.

Depois de ter uma instância de um XmlSchemaObject, você pode usar esse método para validar uma subárvore.

Aplica-se a

.NET 9 e outras versões
Produto Versões
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0, 2.1