AttributeGroup 要素のバインディング サポート

このトピックの対象は、レガシ テクノロジに特定されています。XML Web サービスと XML Web サービス クライアントは以下を使用して作成してください。 Windows Communication Foundation.

.NET Framework では、<attributeGroup> 要素のバインディングを一部サポートしています。

XML スキーマ ドキュメントからソース コードを生成するとき、Xsd.exe は各 <attributeGroup> 参照を、その参照を含んでいる <complexType> 定義に対応するクラスに直接展開します。

説明

<attributeGroup> 要素を使用すると、スキーマの設計で、属性のグループをグローバルに定義でき、参照を経由して、任意の数の複合型でそのグループを再利用できます。

.NET Framework には、属性グループをコードで表現する方法がありません。その代わり、XML スキーマ ドキュメントからソース コードを生成するとき、Xsd.exe は ref 属性によって、各 <attributeGroup> 参照を、その参照を含んでいる <complexType> 定義に対応するクラスに直接展開します。各属性に対して、パブリック フィールドが 1 つ生成されます。各パブリック フィールドは、XmlAttributeAttribute 属性 (XmlAttribute という短い名前で表現されることもある) と共に現れます。

属性バインディングのフィールドまたはプロパティの同じグループを、複数のクラスで直接定義しないようにするには、手動で基本クラスを作成し、その基本クラスから継承された XML スキーマ複合型を表すクラスを用意する方法があります。各パブリック フィールドまたはプロパティは、XmlAttribute 属性と共に使用してください。それ以外の場合は、属性ではなく複合型の要素として解釈されます。

Example

入力 XML スキーマ ドキュメント:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            xmlns="http://example.org/" targetNamespace="http://example.org/" elementFormDefault="qualified">
    <xsd:attributeGroup name="version">
      <xsd:attribute name="changeNumber" type="xsd:int" use="required"/>
      <xsd:attribute name="instanceId" type="xsd:string" use="required"/>
    </xsd:attributeGroup>
    <xsd:complexType name="keyInfo">
      <xsd:sequence>
        <xsd:element name="key" type="xsd:string"/>
      </xsd:sequence>
      <xsd:attributeGroup ref="version" />
    </xsd:complexType>
    <xsd:element name="key" type="keyInfo"/>
</xsd:schema>

上記の XML スキーマ ドキュメントから生成される C# クラス :

[System.Xml.Serialization.XmlTypeAttribute(Namespace="http://example.org/")]
[System.Xml.Serialization.XmlRootAttribute("key", Namespace="http://example.org/", IsNullable=false)]
public class keyInfo {
        
    public string key;
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public int changeNumber;
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public string instanceId;
}

上記の C# ソースからコンパイルされたアセンブリから生成される XML スキーマ複合型 :

<xs:schema xmlns:tns="http://example.org/" elementFormDefault="qualified" targetNamespace="http://example.org/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:element name="key" type="tns:keyInfo" />
  <xs:complexType name="keyInfo">
    <xs:sequence>
      <xs:element minOccurs="0" maxOccurs="1" name="key" type="xs:string" />
    </xs:sequence>
    <xs:attribute name="changeNumber" type="xs:int" />
    <xs:attribute name="instanceId" type="xs:string" />
  </xs:complexType>
</xs:schema>

使用可能な親要素 : <attributeGroup>、<complexType>、<extension>、<redefine>、<restriction>、<schema>

使用可能な子要素 : <annotation>、<anyAttribute>、<attribute>、<attributeGroup>

参照

リファレンス

XmlSchemaAttributeGroup
XmlSchemaAttributeGroupRef