XmlSchemaInference.Occurrence Propriedade

Definição

Obtém ou define o valor de XmlSchemaInference.InferenceOption que afeta as declarações de ocorrência de esquema deduzidas do documento XML.

public:
 property System::Xml::Schema::XmlSchemaInference::InferenceOption Occurrence { System::Xml::Schema::XmlSchemaInference::InferenceOption get(); void set(System::Xml::Schema::XmlSchemaInference::InferenceOption value); };
public System.Xml.Schema.XmlSchemaInference.InferenceOption Occurrence { get; set; }
member this.Occurrence : System.Xml.Schema.XmlSchemaInference.InferenceOption with get, set
Public Property Occurrence As XmlSchemaInference.InferenceOption

Valor da propriedade

XmlSchemaInference.InferenceOption

Um objeto XmlSchemaInference.InferenceOption.

Exemplos

Este exemplo ilustra como a ocorrência é afetada pela Occurrence propriedade. O código de exemplo infere a ocorrência de um arquivo XML de duas maneiras diferentes: relaxado e restrito. Veja a seguir o exemplo de arquivo XML.

<?xml version="1.0"?>
<root>
    <subElement1 attribute1="text">ABC</subElement1>
</root>

O código de exemplo a seguir instrui a XmlSchemaInference classe a inferir a ocorrência de elementos e atributos de maneira descontraída.

XmlReader^ reader = XmlReader::Create("input.xml");
XmlSchemaSet^ schemaSet = gcnew XmlSchemaSet();
XmlSchemaInference^ schema = gcnew XmlSchemaInference();

schema->Occurrence = XmlSchemaInference::InferenceOption::Relaxed;

schemaSet = schema->InferSchema(reader);

for each (XmlSchema^ s in schemaSet->Schemas())
{
    s->Write(Console::Out);
}
XmlReader reader = XmlReader.Create("input.xml");
XmlSchemaSet schemaSet = new XmlSchemaSet();
XmlSchemaInference schema = new XmlSchemaInference();

schema.Occurrence = XmlSchemaInference.InferenceOption.Relaxed;

schemaSet = schema.InferSchema(reader);

foreach (XmlSchema s in schemaSet.Schemas())
{
    s.Write(Console.Out);
}
Dim reader As XmlReader = XmlReader.Create("input.xml")
Dim schemaSet As XmlSchemaSet = New XmlSchemaSet()
Dim schema As XmlSchemaInference = New XmlSchemaInference()

schema.Occurrence = XmlSchemaInference.InferenceOption.Relaxed

schemaSet = schema.InferSchema(reader)

For Each s As XmlSchema In schemaSet.Schemas()
    s.Write(Console.Out)
Next

Como a Occurrence propriedade foi definida como , o esquema a Relaxedseguir foi gerado.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="root">
        <xs:complexType>
            <xs:sequence>
                <xs:element minOccurs="0" name="subElement1">
                    <xs:complexType>
                        <xs:simpleContent>
                            <xs:extension base="xs:string">
                            <xs:attribute name="attribute1" type="xs:string" use="optional"/>
                            </xs:extension>
                        </xs:simpleContent>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

No código de exemplo acima, se a Occurrence propriedade não estivesse definida como Relaxed, a XmlSchemaInference classe teria gerado e gerado o esquema a Restricted seguir.

<?xml version="1.0" encoding="utf-8"?>
<xs:schema attributeFormDefault="unqualified" elementFormDefault="qualified" xmlns:xs="http://www.w3.org/2001/XMLSchema">
    <xs:element name="root">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="subElement1">
                    <xs:complexType>
                        <xs:simpleContent>
                            <xs:extension base="xs:string">
                                <xs:attribute name="attribute1" type="xs:string" use="required"/>
                            </xs:extension>
                        </xs:simpleContent>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

Comentários

Se a Occurrence propriedade estiver definida como Restricted, na primeira vez que os elementos forem encontrados no documento XML, a declaração de esquema será inferida como minOccurs="1". Quando os atributos são encontrados, a declaração de esquema é inferida como use="required".

Se a Occurrence propriedade for definida como Relaxed, as declarações de esquema de elemento serão inferidas como minOccurs="0"e as declarações de esquema de atributo serão inferidas como use="optional".

O valor padrão da Occurrence propriedade é Restricted.

Aplica-se a