XmlSchemaInference.Occurrence プロパティ

.NET Framework クラス ライブラリ リファレンス

XmlSchemaInference.Occurrence プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

XML ドキュメントから推論されるスキーマ出現宣言に影響する XmlSchemaInference.InferenceOption 値を取得または設定します。

名前空間: System.Xml.Schema
アセンブリ: System.Xml (system.xml.dll 内)
構文

Visual Basic (宣言)

Public Property Occurrence As
 InferenceOption

Visual Basic (使用法)

Dim instance As XmlSchemaInference
Dim value As InferenceOption

value = instance.Occurrence

instance.Occurrence = value

C#

public InferenceOption Occurrence { get; set;
 }

C++

public:
property InferenceOption Occurrence {
    InferenceOption get ();
    void set (InferenceOption value);
}

J#

/** @property */
public InferenceOption get_Occurrence ()

/** @property */
public void set_Occurrence (InferenceOption
 value)

JScript

public function get Occurrence
 () : InferenceOption

public function set Occurrence
 (value : InferenceOption)

プロパティ値
XmlSchemaInference.InferenceOption オブジェクト。

解説

Occurrence プロパティが Restricted に設定されている場合、XML ドキュメント内で最初に要素を検出したときに、スキーマ宣言が minOccurs="1" と推論されます。属性を検出すると、スキーマ宣言は use="required" と推論されます。

Occurrence プロパティが Relaxed に設定されている場合、要素スキーマ宣言は minOccurs="0" と推論され、属性スキーマ宣言は use="optional" と推論されます。

Occurrence プロパティの既定値は Restricted です。

使用例

Occurrence プロパティが出現にどのように影響を与えるかを表す例を次に示します。このプログラム例は、Relaxed と Restricted の 2 つの異なる指定方法で XML ファイルから出現を推論します。サンプル XML ファイルを次に示します。

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

次のプログラム例は、Relaxed を指定する方法で要素と属性の出現を推論するように XmlSchemaInference クラスに指示します。

Visual Basic

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
XmlSchemaInference クラス
XmlSchemaInference メンバ
System.Xml.Schema 名前空間