XmlSchemaInference.Occurrence 属性

定义

命名空间:

System.Xml.Schema

程序集:

netstandard.dll, 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 = 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设置为 ，则minOccurs="0"推断元素架构声明，属性架构声明被推断为 use="optional"Relaxed。

Occurrence 属性的默认值为 Restricted。