XmlSchemaInference.Occurrence Propiedad

Definición

Espacio de nombres:

System.Xml.Schema

Ensamblado:

System.Xml.ReaderWriter.dll

Ensamblado:

System.Xml.dll

Ensamblado:

netstandard.dll

Obtiene o establece el valor de XmlSchemaInference.InferenceOption que afecta a las declaraciones de aparición de esquemas que se infieren del 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 propiedad

XmlSchemaInference.InferenceOption

Un objeto XmlSchemaInference.InferenceOption.

Ejemplos

En este ejemplo se muestra cómo afecta la repetición a la Occurrence propiedad . El código de ejemplo deduce la repetición de un archivo XML de dos maneras diferentes: relajado y restringido. A continuación se muestra el archivo XML de ejemplo.

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

En el código de ejemplo siguiente se indica a la XmlSchemaInference clase que infiere la aparición de elementos y atributos de forma relajada.

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

Dado que la Occurrence propiedad se estableció Relaxeden , se generó el esquema siguiente.

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

En el código de ejemplo anterior, si la Occurrence propiedad no se estableció Relaxeden , la clase tendría como XmlSchemaInference valor predeterminado Restricted y generaría el esquema siguiente.

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

Comentarios

Si la Occurrence propiedad se establece Restricteden , los primeros elementos se encuentran en el documento XML, la declaración de esquema se deduce como minOccurs="1". Cuando se encuentran atributos, la declaración de esquema se deduce como use="required".

Si la Occurrence propiedad se establece Relaxeden , las declaraciones de esquema de elemento se deducen como minOccurs="0", y las declaraciones de esquema de atributo se deducen como use="optional".

El valor predeterminado de la Occurrence propiedad es Restricted.