XmlSchemaInference.Occurrence Propriedade

Definição

Espaço de Nomes:
System.Xml.Schema
Assemblagens:
netstandard.dll, System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.ReaderWriter.dll
Assemblagem:
System.Xml.dll
Assemblagem:
netstandard.dll
Origem:
Infer.cs
Origem:
Infer.cs
Origem:
Infer.cs
Origem:
Infer.cs
Origem:
Infer.cs

Recebe ou define o XmlSchemaInference.InferenceOption valor que afeta as declarações de ocorrência de esquema inferidas a partir 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 de Propriedade

XmlSchemaInference.InferenceOption

Um XmlSchemaInference.InferenceOption objeto.

Exemplos

Este exemplo ilustra como a ocorrência é afetada pela Occurrence propriedade. O código de exemplo infere ocorrência a partir de um ficheiro XML de duas formas diferentes: relaxado e restrito. Segue-se o ficheiro XML de exemplo.

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

O seguinte código de exemplo instrui a XmlSchemaInference classe a inferir a ocorrência de elementos e atributos de forma relaxada.

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 para Relaxed, foi gerado o seguinte esquema.

<?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 para Relaxed, a XmlSchemaInference classe teria dado por defeito Restricted e gerado o seguinte esquema.

<?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>

Observações

Se a Occurrence propriedade for definida para Restricted, na primeira vez que elementos são encontrados no documento XML, a declaração do esquema é inferida como minOccurs="1". Quando são encontrados atributos, a declaração do esquema é inferida como use="required".

Se a Occurrence propriedade for definida como Relaxed, as declarações de esquema de elementos são inferidas como minOccurs="0", e as declarações de esquemas de atributos são inferidas como use="optional".

O valor padrão da Occurrence propriedade é Restricted.

Aplica-se a