XmlSchemaInference.Occurrence 属性

定义

命名空间:

System.Xml.Schema

程序集:

System.Xml.ReaderWriter.dll

Source:

Infer.cs

获取或设置 XmlSchemaInference.InferenceOption 值，该值影响从 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

属性值

XmlSchemaInference.InferenceOption

一个 XmlSchemaInference.InferenceOption 对象。

示例

此示例演示了 属性对匹配项的影响 Occurrence 。 示例代码以两种不同的方式推断 XML 文件中的出现情况：宽松和受限。 下面是示例 XML 文件。

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

以下示例代码指示 XmlSchemaInference 类以宽松的方式推断元素和属性的出现情况。

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

由于 属性 Occurrence 设置为 Relaxed，因此生成了以下架构。

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

在上面的示例代码中 Occurrence ，如果 属性未设置为 Relaxed，则 XmlSchemaInference 类将默认为 Restricted 并生成以下架构。

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

注解

如果 属性 Occurrence 设置为 Restricted，则第一次在 XML 文档中遇到元素时，架构声明被推断为 minOccurs="1"。 遇到属性时，架构声明被推断为 use="required"。

如果 属性 Occurrence 设置为 Relaxed，则元素架构声明推断为 minOccurs="0"，属性架构声明推断为 use="optional"。

属性的 Occurrence 默认值为 Restricted。