XmlSchemaElement Klasa

Odwołanie

Definicja

Przestrzeń nazw:: System.Xml.Schema

Zestaw:: System.Xml.ReaderWriter.dll

Zestaw:: System.Xml.dll

Zestaw:: netstandard.dll

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

element Reprezentuje element ze schematu XML określony przez World Wide Web Consortium (W3C). Ta klasa jest klasą bazową dla wszystkich typów cząstek i służy do opisywania elementu w dokumencie XML.

public ref class XmlSchemaElement : System::Xml::Schema::XmlSchemaParticle

public class XmlSchemaElement : System.Xml.Schema.XmlSchemaParticle

type XmlSchemaElement = class
    inherit XmlSchemaParticle

Public Class XmlSchemaElement
Inherits XmlSchemaParticle

Dziedziczenie: Object

XmlSchemaObject

XmlSchemaAnnotated

XmlSchemaParticle
XmlSchemaElement

Przykłady

Poniższy przykład tworzy element element.

#using <mscorlib.dll>
#using <System.Xml.dll>

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

class XmlSchemaExamples
{
public:

    static void Main()
    {
        XmlSchema^ schema = gcnew XmlSchema();

        // <xs:element name="cat" type="string"/>
        XmlSchemaElement^ elementCat = gcnew XmlSchemaElement();
        schema->Items->Add(elementCat);
        elementCat->Name = "cat";
        elementCat->SchemaTypeName = gcnew XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");

        // <xs:element name="dog" type="string"/>
        XmlSchemaElement^ elementDog = gcnew XmlSchemaElement();
        schema->Items->Add(elementDog);
        elementDog->Name = "dog";
        elementDog->SchemaTypeName = gcnew XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");

        // <xs:element name="redDog" substitutionGroup="dog" />
        XmlSchemaElement^ elementRedDog = gcnew XmlSchemaElement();
        schema->Items->Add(elementRedDog);
        elementRedDog->Name = "redDog";
        elementRedDog->SubstitutionGroup = gcnew XmlQualifiedName("dog");

        // <xs:element name="brownDog" substitutionGroup ="dog" />
        XmlSchemaElement^ elementBrownDog = gcnew XmlSchemaElement();
        schema->Items->Add(elementBrownDog);
        elementBrownDog->Name = "brownDog";
        elementBrownDog->SubstitutionGroup = gcnew XmlQualifiedName("dog");

        // <xs:element name="pets">
        XmlSchemaElement^ elementPets = gcnew XmlSchemaElement();
        schema->Items->Add(elementPets);
        elementPets->Name = "pets";

        // <xs:complexType>
        XmlSchemaComplexType^ complexType = gcnew XmlSchemaComplexType();
        elementPets->SchemaType = complexType;

        // <xs:choice minOccurs="0" maxOccurs="unbounded">
        XmlSchemaChoice^ choice = gcnew XmlSchemaChoice();
        complexType->Particle = choice;
        choice->MinOccurs = 0;
        choice->MaxOccursString = "unbounded";

        // <xs:element ref="cat"/>
        XmlSchemaElement^ catRef = gcnew XmlSchemaElement();
        choice->Items->Add(catRef);
        catRef->RefName = gcnew XmlQualifiedName("cat");

        // <xs:element ref="dog"/>
        XmlSchemaElement^ dogRef = gcnew XmlSchemaElement();
        choice->Items->Add(dogRef);
        dogRef->RefName = gcnew XmlQualifiedName("dog");

        XmlSchemaSet^ schemaSet = gcnew XmlSchemaSet();
        schemaSet->ValidationEventHandler += gcnew ValidationEventHandler(ValidationCallbackOne);
        schemaSet->Add(schema);
        schemaSet->Compile();

        XmlSchema^ compiledSchema;

        for each (XmlSchema^ schema1 in schemaSet->Schemas())
        {
            compiledSchema = schema1;
        }

        XmlNamespaceManager^ nsmgr = gcnew XmlNamespaceManager(gcnew NameTable());
        nsmgr->AddNamespace("xs", "http://www.w3.org/2001/XMLSchema");
        compiledSchema->Write(Console::Out, nsmgr);
    }

    static void ValidationCallbackOne(Object^ sender, ValidationEventArgs^ args)
    {
        Console::WriteLine(args->Message);
    }
};

int main()
{
    XmlSchemaExamples::Main();
    return 0;
};

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

class XMLSchemaExamples
{
    public static void Main()
    {

        XmlSchema schema = new XmlSchema();

        // <xs:element name="cat" type="string"/>
        XmlSchemaElement elementCat = new XmlSchemaElement();
        schema.Items.Add(elementCat);
        elementCat.Name = "cat";
        elementCat.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");

        // <xs:element name="dog" type="string"/>
        XmlSchemaElement elementDog = new XmlSchemaElement();
        schema.Items.Add(elementDog);
        elementDog.Name = "dog";
        elementDog.SchemaTypeName = new XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema");

        // <xs:element name="redDog" substitutionGroup="dog" />
        XmlSchemaElement elementRedDog = new XmlSchemaElement();
        schema.Items.Add(elementRedDog);
        elementRedDog.Name = "redDog";
        elementRedDog.SubstitutionGroup = new XmlQualifiedName("dog");

        // <xs:element name="brownDog" substitutionGroup ="dog" />
        XmlSchemaElement elementBrownDog = new XmlSchemaElement();
        schema.Items.Add(elementBrownDog);
        elementBrownDog.Name = "brownDog";
        elementBrownDog.SubstitutionGroup = new XmlQualifiedName("dog");

        // <xs:element name="pets">
        XmlSchemaElement elementPets = new XmlSchemaElement();
        schema.Items.Add(elementPets);
        elementPets.Name = "pets";

        // <xs:complexType>
        XmlSchemaComplexType complexType = new XmlSchemaComplexType();
        elementPets.SchemaType = complexType;

        // <xs:choice minOccurs="0" maxOccurs="unbounded">
        XmlSchemaChoice choice = new XmlSchemaChoice();
        complexType.Particle = choice;
        choice.MinOccurs = 0;
        choice.MaxOccursString = "unbounded";

        // <xs:element ref="cat"/>
        XmlSchemaElement catRef = new XmlSchemaElement();
        choice.Items.Add(catRef);
        catRef.RefName = new XmlQualifiedName("cat");

        // <xs:element ref="dog"/>
        XmlSchemaElement dogRef = new XmlSchemaElement();
        choice.Items.Add(dogRef);
        dogRef.RefName = new XmlQualifiedName("dog");

        XmlSchemaSet schemaSet = new XmlSchemaSet();
        schemaSet.ValidationEventHandler += new ValidationEventHandler(ValidationCallbackOne);
        schemaSet.Add(schema);
        schemaSet.Compile();

        XmlSchema compiledSchema = null;

        foreach (XmlSchema schema1 in schemaSet.Schemas())
        {
            compiledSchema = schema1;
        }

        XmlNamespaceManager nsmgr = new XmlNamespaceManager(new NameTable());
        nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema");
        compiledSchema.Write(Console.Out, nsmgr);
    }

    public static void ValidationCallbackOne(object sender, ValidationEventArgs args)
    {
        Console.WriteLine(args.Message);
    }
}

Imports System.Xml
Imports System.Xml.Schema

Class XMLSchemaExamples
    Public Shared Sub Main()

        Dim schema As New XmlSchema()

        ' <xs:element name="cat" type="string"/>
        Dim elementCat As New XmlSchemaElement()
        schema.Items.Add(elementCat)
        elementCat.Name = "cat"
        elementCat.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")

        ' <xs:element name="dog" type="string"/>
        Dim elementDog As New XmlSchemaElement()
        schema.Items.Add(elementDog)
        elementDog.Name = "dog"
        elementDog.SchemaTypeName = New XmlQualifiedName("string", "http://www.w3.org/2001/XMLSchema")

        ' <xs:element name="redDog" substitutionGroup="dog" />
        Dim elementRedDog As New XmlSchemaElement()
        schema.Items.Add(elementRedDog)
        elementRedDog.Name = "redDog"
        elementRedDog.SubstitutionGroup = New XmlQualifiedName("dog")


        ' <xs:element name="brownDog" substitutionGroup ="dog" />
        Dim elementBrownDog As New XmlSchemaElement()
        schema.Items.Add(elementBrownDog)
        elementBrownDog.Name = "brownDog"
        elementBrownDog.SubstitutionGroup = New XmlQualifiedName("dog")


        ' <xs:element name="pets">
        Dim elementPets As New XmlSchemaElement()
        schema.Items.Add(elementPets)
        elementPets.Name = "pets"

        ' <xs:complexType>
        Dim complexType As New XmlSchemaComplexType()
        elementPets.SchemaType = complexType

        ' <xs:choice minOccurs="0" maxOccurs="unbounded">
        Dim choice As New XmlSchemaChoice()
        complexType.Particle = choice
        choice.MinOccurs = 0
        choice.MaxOccursString = "unbounded"

        ' <xs:element ref="cat"/>
        Dim catRef As New XmlSchemaElement()
        choice.Items.Add(catRef)
        catRef.RefName = New XmlQualifiedName("cat")

        ' <xs:element ref="dog"/>
        Dim dogRef As New XmlSchemaElement()
        choice.Items.Add(dogRef)
        dogRef.RefName = New XmlQualifiedName("dog")

        Dim schemaSet As New XmlSchemaSet()
        AddHandler schemaSet.ValidationEventHandler, AddressOf ValidationCallbackOne

        schemaSet.Add(schema)
        schemaSet.Compile()

        Dim compiledSchema As XmlSchema = Nothing

        For Each schema1 As XmlSchema In schemaSet.Schemas()
            compiledSchema = schema1
        Next

        Dim nsmgr As New XmlNamespaceManager(New NameTable())
        nsmgr.AddNamespace("xs", "http://www.w3.org/2001/XMLSchema")
        compiledSchema.Write(Console.Out, nsmgr)

    End Sub

    Public Shared Sub ValidationCallbackOne(ByVal sender As Object, ByVal args As ValidationEventArgs)
        Console.WriteLine(args.Message)
    End Sub

End Class

Poniższy plik XML jest używany w poprzednim przykładzie kodu.

<?xml version="1.0" encoding="IBM437"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="cat" type="xs:string"/>
    <xs:element name="dog" type="xs:string"/>
    <xs:element name="redDog" substitutionGroup="dog" />
    <xs:element name="brownDog" substitutionGroup ="dog" />

    <xs:element name="pets">
      <xs:complexType>
        <xs:choice minOccurs="0" maxOccurs="unbounded">
          <xs:element ref="cat"/>
          <xs:element ref="dog"/>
        </xs:choice>
      </xs:complexType>
    </xs:element>
</xs:schema>

Uwagi

Ważne

Nie używaj schematów z nieznanych lub niezaufanych źródeł ani lokalizacji. Spowoduje to naruszenie zabezpieczeń kodu.
Schematy XML (w tym schematy wbudowane) są z natury narażone na ataki typu "odmowa usługi"; nie akceptuj ich w niezaufanych scenariuszach.
Komunikaty o błędach weryfikacji schematu i wyjątki mogą uwidaczniać poufne informacje o modelu zawartości lub ścieżkach identyfikatorów URI do pliku schematu. Uważaj, aby nie ujawniać tych informacji niezaufanym wywołującym.

Konstruktory

XmlSchemaElement()

Inicjuje nowe wystąpienie klasy XmlSchemaElement.

Właściwości

Annotation	Pobiera lub ustawia `annotation` właściwość. (Odziedziczone po XmlSchemaAnnotated)
Block	Pobiera lub ustawia `Block` wyprowadzenie.
BlockResolved	Pobiera wartość `Block` po kompilacji właściwości.
Constraints	Pobiera kolekcję ograniczeń dla elementu.
DefaultValue	Pobiera lub ustawia wartość domyślną elementu, jeśli jego zawartość jest prostym typem lub zawartością elementu jest `textOnly`.
ElementSchemaType	XmlSchemaType Pobiera obiekt reprezentujący typ elementu na SchemaType podstawie wartości lub SchemaTypeName elementu.
ElementType	Nieaktualne. Nieaktualne. Nieaktualne. Pobiera obiekt środowiska uruchomieniowego języka wspólnego (CLR) na XmlSchemaElement podstawie elementu lub XmlSchemaElement , który zawiera wartość `ElementType` po kompilacji właściwości.
Final	Pobiera lub ustawia właściwość, `Final` aby wskazać, że nie są dozwolone żadne dalsze wyprowadzenia.
FinalResolved	Pobiera wartość `Final` po kompilacji właściwości.
FixedValue	Pobiera lub ustawia stałą wartość.
Form	Pobiera lub ustawia formularz dla elementu.
Id	Pobiera lub ustawia identyfikator ciągu. (Odziedziczone po XmlSchemaAnnotated)
IsAbstract	Pobiera lub ustawia informacje wskazujące, czy element może być używany w dokumencie wystąpienia.
IsNillable	Pobiera lub ustawia informacje wskazujące, czy `xsi:nil` mogą wystąpić w danych wystąpienia. Wskazuje, czy do elementu można przypisać jawną wartość zerową.
LineNumber	Pobiera lub ustawia numer wiersza w pliku, do którego `schema` odwołuje się element. (Odziedziczone po XmlSchemaObject)
LinePosition	Pobiera lub ustawia położenie wiersza w pliku, do którego `schema` odwołuje się element. (Odziedziczone po XmlSchemaObject)
MaxOccurs	Pobiera lub ustawia maksymalną liczbę wystąpień cząstek. (Odziedziczone po XmlSchemaParticle)
MaxOccursString	Pobiera lub ustawia liczbę jako wartość ciągu. Maksymalna liczba wystąpień cząstek. (Odziedziczone po XmlSchemaParticle)
MinOccurs	Pobiera lub ustawia minimalną liczbę wystąpień cząstek. (Odziedziczone po XmlSchemaParticle)
MinOccursString	Pobiera lub ustawia liczbę jako wartość ciągu. Minimalna liczba wystąpień cząstki. (Odziedziczone po XmlSchemaParticle)
Name	Pobiera lub ustawia nazwę elementu.
Namespaces	Pobiera lub ustawia XmlSerializerNamespaces obiekt do użycia z tym obiektem schematu. (Odziedziczone po XmlSchemaObject)
Parent	Pobiera lub ustawia element nadrzędny tego XmlSchemaObjectobiektu . (Odziedziczone po XmlSchemaObject)
QualifiedName	Pobiera rzeczywistą kwalifikowaną nazwę danego elementu.
RefName	Pobiera lub ustawia nazwę odwołania elementu zadeklarowanego w tym schemacie (lub inny schemat wskazany przez określoną przestrzeń nazw).
SchemaType	Pobiera lub ustawia typ elementu. Może to być typ złożony lub prosty.
SchemaTypeName	Pobiera lub ustawia nazwę wbudowanego typu danych zdefiniowanego w tym schemacie lub inny schemat wskazany przez określoną przestrzeń nazw.
SourceUri	Pobiera lub ustawia lokalizację źródłową pliku, który załadował schemat. (Odziedziczone po XmlSchemaObject)
SubstitutionGroup	Pobiera lub ustawia nazwę elementu, który jest zastępowany przez ten element.
UnhandledAttributes	Pobiera lub ustawia kwalifikowane atrybuty, które nie należą do docelowej przestrzeni nazw bieżącego schematu. (Odziedziczone po XmlSchemaAnnotated)

Metody

Equals(Object)	Określa, czy dany obiekt jest taki sam, jak bieżący obiekt. (Odziedziczone po Object)
GetHashCode()	Służy jako domyślna funkcja skrótu. (Odziedziczone po Object)
GetType()	Type Pobiera wartość bieżącego wystąpienia. (Odziedziczone po Object)
MemberwiseClone()	Tworzy płytkią kopię bieżącego Objectelementu . (Odziedziczone po Object)
ToString()	Zwraca ciąg reprezentujący bieżący obiekt. (Odziedziczone po Object)

Dotyczy