XmlSchemaInference.Occurrence 屬性

定義

命名空間:

System.Xml.Schema

組件:

System.Xml.ReaderWriter.dll

組件:

System.Xml.dll

組件:

netstandard.dll

取得或設定 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 。