XmlSchemaInference.Occurrence 屬性

定義

取得或設定 XmlSchemaInference.InferenceOption 值,影響從 XML 文件推斷的結構描述符合項目宣告。

C#
public System.Xml.Schema.XmlSchemaInference.InferenceOption Occurrence { get; set; }

屬性值

XmlSchemaInference.InferenceOption

XmlSchemaInference.InferenceOption 物件。

範例

此範例說明屬性如何影響 Occurrence 發生次數。 此範例程式碼會以兩種不同的方式從 XML 檔案推斷發生:寬鬆和受限。 以下是 XML 檔案範例。

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

下列範例程式碼會 XmlSchemaInference 指示 類別以寬鬆的方式推斷元素和屬性的出現次數。

C#
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);
}

Occurrence因為 屬性設定 Relaxed 為 ,所以會產生下列架構。

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

適用於

產品 版本
.NET Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7
.NET Framework 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8
.NET Standard 2.0, 2.1