Extensions.GetSchemaInfo Méthode

Référence

Définition

Espace de noms:: System.Xml.Schema

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un nœud validé.

Surcharges

GetSchemaInfo(XAttribute)	Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un attribut validé.
GetSchemaInfo(XElement)	Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un élément validé.

Remarques

Une fois que vous avez validé un XDocument, vous pouvez récupérer l’ensemble d’informations post-validation du schéma pour un XElement ou XAttribute contenu dans le document.

Après avoir récupéré l’objet IXmlSchemaInfo , vous pouvez utiliser les SchemaAttribute propriétés ou SchemaElement pour obtenir un type de validation partielle (XmlSchemaElement ou XmlSchemaAttribute). Vous pouvez utiliser les types de validation partielle pour valider un attribut ou une sous-arborescence.

GetSchemaInfo(XAttribute)

Source:: XNodeValidator.cs

Source:: XNodeValidator.cs

Source:: XNodeValidator.cs

Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un attribut validé.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Xml::Schema::IXmlSchemaInfo ^ GetSchemaInfo(System::Xml::Linq::XAttribute ^ source);

public static System.Xml.Schema.IXmlSchemaInfo? GetSchemaInfo (this System.Xml.Linq.XAttribute source);

public static System.Xml.Schema.IXmlSchemaInfo GetSchemaInfo (this System.Xml.Linq.XAttribute source);

static member GetSchemaInfo : System.Xml.Linq.XAttribute -> System.Xml.Schema.IXmlSchemaInfo

<Extension()>
Public Function GetSchemaInfo (source As XAttribute) As IXmlSchemaInfo

Paramètres

source: XAttribute

XAttribute validé précédemment.

Retours

IXmlSchemaInfo

IXmlSchemaInfo qui contient le jeu d'informations postérieures à la validation du schéma pour un XAttribute.

Remarques

Vous pouvez utiliser le IXmlSchemaInfo retourné par cette méthode pour déterminer certaines caractéristiques d’un attribut validé. Par exemple, vous pouvez déterminer si l’attribut provient d’une valeur d’attribut par défaut dans un XSD.

Vous utilisez la SchemaAttribute propriété pour obtenir un type de validation partielle (XmlSchemaAttribute). Vous pouvez l’utiliser pour revalider un attribut sans valider un document entier.

Pour obtenir un exemple de cette propriété, consultez Validate.

S’applique à

GetSchemaInfo(XElement)

Source:: XNodeValidator.cs

Source:: XNodeValidator.cs

Source:: XNodeValidator.cs

Obtient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) d'un élément validé.

public:
[System::Runtime::CompilerServices::Extension]
 static System::Xml::Schema::IXmlSchemaInfo ^ GetSchemaInfo(System::Xml::Linq::XElement ^ source);

public static System.Xml.Schema.IXmlSchemaInfo? GetSchemaInfo (this System.Xml.Linq.XElement source);

public static System.Xml.Schema.IXmlSchemaInfo GetSchemaInfo (this System.Xml.Linq.XElement source);

static member GetSchemaInfo : System.Xml.Linq.XElement -> System.Xml.Schema.IXmlSchemaInfo

<Extension()>
Public Function GetSchemaInfo (source As XElement) As IXmlSchemaInfo

Paramètres

source: XElement

XElement validé précédemment.

Retours

IXmlSchemaInfo

IXmlSchemaInfo qui contient le jeu d'informations postérieures à la validation du schéma (jeu PSVI) pour un XElement.

Exemples

L’exemple suivant remplit l’arborescence avec un PSVI. Après validation, il imprime tous les éléments et attributs de l’arborescence qui ne sont pas valides selon le 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);  
}

                Private Sub DumpInvalidNodes(ByVal el As XElement)  
    If el.GetSchemaInfo.Validity <> XmlSchemaValidity.Valid Then  
        Console.WriteLine("Invalid Element {0}", _  
            el _  
            .AncestorsAndSelf _  
            .InDocumentOrder() _  
            .Aggregate("", _  
                Function(ByVal s, ByVal i) s + "/" + i.Name.ToString()))  
    End If  
    For Each att As XAttribute In el.Attributes()  
        If att.GetSchemaInfo.Validity <> XmlSchemaValidity.Valid Then  
            Console.WriteLine("Invalid Attribute {0}", _  
                att _  
                .Parent _  
                .AncestorsAndSelf() _  
                .InDocumentOrder() _  
                .Aggregate("", _  
                    Function(ByVal s, ByVal i) s + "/" + i.Name.ToString()) + _  
                    "/@" + att.Name.ToString())  
        End If  
    Next  
    For Each child As XElement In el.Elements()  
        DumpInvalidNodes(child)  
    Next  
End Sub  

Dim errors As Boolean = False  

Private Sub XSDErrors(ByVal o As Object, ByVal e As ValidationEventArgs)  
    Console.WriteLine("{0}", e.Message)  
    errors = True  
End Sub  

Sub Main()  
    Dim xsdMarkup As XDocument = _  
    <?xml version='1.0'?>  
    <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>  

    Dim schemas As XmlSchemaSet = New XmlSchemaSet()  
    schemas.Add("", xsdMarkup.CreateReader)  

    Dim doc1 As XDocument = _  
    <?xml version='1.0'?>  
    <Root>  
        <Child1>  
            <GrandChild1>AAA</GrandChild1>  
            <GrandChild2>ZZZ</GrandChild2>  
            <GrandChild3>ZZZ</GrandChild3>  
        </Child1>  
    </Root>  

    Console.WriteLine("Validating doc1 ...")  
    errors = False  
    doc1.Validate(schemas, AddressOf XSDErrors, True)  
    Console.WriteLine("doc1 {0}", IIf(errors, "did not validate", "validated"))  
    DumpInvalidNodes(doc1.Root)  
End Sub

Cet exemple produit la sortie suivante :

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

Remarques

Vous pouvez utiliser le IXmlSchemaInfo retourné par cette méthode pour déterminer certaines caractéristiques d’un élément validé. Par exemple, vous pouvez déterminer le type de schéma dynamique de l’élément .

Vous utilisez la SchemaElement propriété pour obtenir un type de validation partielle (XmlSchemaElement). Vous pouvez l’utiliser pour revalider une sous-arborescence avec un élément à sa racine sans valider un document entier.

Pour obtenir un exemple de cette propriété, consultez Validate.

S’applique à

Extensions.GetSchemaInfo Méthode

Définition

Surcharges

Remarques

GetSchemaInfo(XAttribute)

Paramètres

Retours

Remarques

S’applique à

GetSchemaInfo(XElement)

Paramètres

Retours

Exemples

Remarques

S’applique à

Commentaires

Ressources supplémentaires