Extensions.GetSchemaInfo Methode

Referenz

Definition

Namespace:: System.Xml.Schema

Assembly:: System.Xml.XDocument.dll

Assembly:: System.Xml.Linq.dll

Assembly:: netstandard.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft das Post-Schema-Validation-Infoset (PSVI) eines validierten Knotens ab.

Überlädt

GetSchemaInfo(XAttribute)	Ruft das Post-Schema-Validation-Infoset (PSVI) eines validierten Attributs ab.
GetSchemaInfo(XElement)	Ruft das Post-Schema-Validation-Infoset (PSVI) eines validierten Elements ab.

Hinweise

Nachdem Sie eine Überprüfung überprüft haben, können Sie das Nachschemaüberprüfungs-Infoset für ein XDocument XElement XAttribute oder das im Dokument enthaltene Infoset abrufen.

Nach dem Abrufen des IXmlSchemaInfo Objekts können Sie die SchemaAttribute Eigenschaften SchemaElement verwenden, um einen Teilüberprüfungstyp (XmlSchemaElement oder XmlSchemaAttribute) abzurufen. Sie können die Teilüberprüfungstypen verwenden, um ein Attribut oder eine Unterstruktur zu überprüfen.

GetSchemaInfo(XAttribute)

Ruft das Post-Schema-Validation-Infoset (PSVI) eines validierten Attributs ab.

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

Parameter

source: XAttribute

Ein XAttribute, das zuvor validiert wurde.

Gibt zurück

IXmlSchemaInfo

Eine IXmlSchemaInfo, die das Post-Schema-Validation-Infoset für ein XAttribute enthält.

Hinweise

Sie können die IXmlSchemaInfo von dieser Methode zurückgegebene Methode verwenden, um bestimmte Merkmale eines überprüften Attributs zu bestimmen. Sie können z. B. bestimmen, ob das Attribut aus einem Standardattributewert in einem XSD stammt.

Sie verwenden die SchemaAttribute Eigenschaft, um einen Teilüberprüfungstyp (XmlSchemaAttribute) abzurufen. Sie können es verwenden, um ein Attribut neu zu aktualisieren, ohne ein gesamtes Dokument zu überprüfen.

Ein Beispiel für diese Eigenschaft finden Sie unter Validate.

Gilt für

GetSchemaInfo(XElement)

Ruft das Post-Schema-Validation-Infoset (PSVI) eines validierten Elements ab.

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

Parameter

source: XElement

Ein XElement, das zuvor validiert wurde.

Gibt zurück

IXmlSchemaInfo

Eine IXmlSchemaInfo, die das Post-Schema-Validation-Infoset (PSVI) für ein XElement enthält.

Beispiele

Im folgenden Beispiel wird die Struktur mit einem PSVI aufgefüllt. Nach der Überprüfung werden alle Elemente und Attribute in der Struktur gedruckt, die gemäß der PSVI ungültig sind.

                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

Dieses Beispiel erzeugt die folgende Ausgabe:

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

Hinweise

Sie können die IXmlSchemaInfo von dieser Methode zurückgegebene Methode verwenden, um bestimmte Merkmale eines überprüften Elements zu bestimmen. Sie können beispielsweise den dynamischen Schematyp des Elements bestimmen.

Sie verwenden die SchemaElement Eigenschaft, um einen Teilüberprüfungstyp (XmlSchemaElement) abzurufen. Sie können es verwenden, um eine Unterstruktur mit einem Element im Stamm zu überprüfen, ohne ein gesamtes Dokument zu überprüfen.

Ein Beispiel für diese Eigenschaft finden Sie unter Validate.

Gilt für

Extensions.GetSchemaInfo Methode

Definition

Überlädt

Hinweise

GetSchemaInfo(XAttribute)

Parameter

Gibt zurück

Hinweise

Gilt für

GetSchemaInfo(XElement)

Parameter

Gibt zurück

Beispiele

Hinweise

Gilt für

Zusätzliche Ressourcen