Attribute 요소의 바인딩 지원

이 항목은 레거시 기술과 관련된 것입니다. 이제 XML Web services와 XML Web services 클라이언트는 다음을 사용하여 만들어야 합니다. Windows Communication Foundation.

.NET Framework에서는 <attribute> 요소에 대한 바인딩 지원을 제공합니다.

그러나, Xsd.exe에서는 전역 특성이 스키마 대상 네임스페이스 이외의 네임스페이스에서 선언된 경우를 제외하고는 로컬로 선언된 특성과 전역으로 선언된 특성에 대한 참조를 구분하지 않습니다.

설명

XML 스키마 사양에는 특성이 복합 형식 정의 내에서 로컬로 또는 전역으로 선언될 수 있으며, 이렇게 선언된 속성은 ref 특성을 통해 하나 이상의 복합 형식에 의해 참조될 수 있다고 나와 있습니다.

다음은 로컬로 선언된 특성의 예입니다.

<xsd:complexType name="PurchaseOrderType">
  <xsd:sequence>
    <xsd:element name="field1" type="xsd:string"/>
  </xsd:sequence>
  <xsd:attribute name="name" type="xsd:string"/>
</xsd:complexType>

다음은 같은 특성이 전역으로 선언된 다음 참조되는 예입니다.

<xsd:attribute name="name" type="xsd:string"/>
<xsd:complexType name="PurchaseOrderType">
  <xsd:sequence>
    <xsd:element name="field1" type="xsd:string"/>
  </xsd:sequence>
  <xsd:attribute ref="name"/>
</xsd:complexType>

Xsd.exe에서는 전역 특성이 스키마 대상 네임스페이스 이외의 네임스페이스에서 선언된 경우를 제외하고는 로컬로 선언된 특성과 전역으로 선언된 특성에 대한 참조를 구분하지 않습니다.

동일한 네임스페이스 내의 참조

Xsd.exe는 동일한 네임스페이스 내에서는 구분을 하지 않으므로 XML 스키마에서 클래스로의 라운드트립 변환 및 그 반대 방향의 라운드트립 변환이 수행되면 전역 특성과 참조를 대체하는 로컬 특성이 만들어집니다.

다른 네임스페이스에 대한 참조

참조된 전역 선언이 다른 네임스페이스에 속할 경우 Xsd.exe는 생성된 필드에 적용되는 XmlAttributeAttribute 특성의 Namespace 속성을 사용하여 네임스페이스를 지정합니다. 이러한 특정 요소의 경우 Namespace 속성을 통해 지정된 네임스페이스가 XmlTypeAttribute 특성이나 XmlRootAttribute를 사용하여 클래스 수준에서 지정된 네임스페이스를 재정의합니다. 이러한 예제는 다음과 같습니다.

[System.Xml.Serialization.XmlAttributeAttribute(Namespace="http://example.org/attr")]

공개 문자열 키;

추가 네임스페이스는 <import> 요소를 사용하여 XML 스키마 정의로 가져옵니다.

Example

이 첫 번째 예제에서는 전역 특성이 해당 전역 특성에 대한 참조를 포함하는 동일한 대상 네임스페이스에 정의되어 있는 경우 Xsd.exe에서 이러한 전역 특성을 처리하는 방법을 보여 줍니다.

입력 XML 스키마 문서:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
            xmlns="http://example.org/" targetNamespace="http://example.org/" elementFormDefault="qualified">
  <xsd:attribute name="version" type="xsd:string"/>
  <xsd:complexType name="keyInfo">
    <xsd:attribute ref="version" />
    <xsd:attribute name="public" type="xsd:boolean" use="required"/>
  </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 {
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public string version;
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public bool @public;
}

앞의 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:attribute name="version" type="xs:string" />
    <xs:attribute name="public" type="xs:boolean" />
  </xs:complexType>
</xs:schema>

앞에서 생성된 XML 스키마에서는 원래 전역으로 선언된 버전 특성이 로컬 특성이 되었습니다.

다음 두 번째 예제에서는 전역 특성이 별도의 네임스페이스에 정의된 경우 Xsd.exe가 이 전역 특성에 대한 참조를 처리하는 방법을 보여 줍니다. 이 예제에서는 <import> 요소를 사용하여 별도의 XSD 파일에 있는 두 번째 네임스페이스를 가져옵니다. 가져온 .xsd 파일의 위치를 지정하는 데는 <import> 요소의 schemaLocation 특성이 사용되지 않습니다. 대신, Xsd.exe에서는 이 파일을 추가 명령줄 인수로 지정합니다.

입력으로 사용되는 최상위 XML 스키마 문서:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
            xmlns="http://example.org/" targetNamespace="http://example.org/" xmlns:attr="http://example.org/attr">
  <xsd:import  namespace="http://example.org/attr" />
  <xsd:element name="key" type="keyInfo" />
  <xsd:complexType name="keyInfo">
    <xsd:attribute ref="attr:version" />
    <xsd:attribute name="public" type="xsd:boolean" use="required" />
  </xsd:complexType>
</xsd:schema> 

입력으로 사용되는 가져온 XML 스키마 문서:

<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified" 
            xmlns="http://example.org/attr" targetNamespace="http://example.org/attr">
  <xsd:attribute name="version" type="xsd:string" />
</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 {
        
    [System.Xml.Serialization.XmlAttributeAttribute(Namespace="http://example.org/attr")]
    public string version;
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public bool @public;
}

앞의 C# 소스에서 컴파일된 어셈블리에서 생성된 최상위 XML 스키마 문서:

<xs:schema xmlns:tns="http://example.org/" elementFormDefault="qualified" targetNamespace="http://example.org/" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:import namespace="http://example.org/attr" />
  <xs:element name="key" type="tns:keyInfo" />
  <xs:complexType name="keyInfo">
    <xs:attribute xmlns:q1="http://example.org/attr" ref="q1:version" />
    <xs:attribute name="public" type="xs:boolean" />
  </xs:complexType>
</xs:schema>

앞의 C# 소스에서 컴파일된 어셈블리에서 생성된 가져온 XML 스키마 문서:

<xs:schema xmlns:tns="http://example.org/attr" elementFormDefault="qualified" targetNamespace="http://example.org/attr" xmlns:xs="http://www.w3.org/2001/XMLSchema">
  <xs:attribute name="version" type="xs:string" />
</xs:schema>

Use 특성

<attribute> 선언의 use 특성은 XML 인스턴스 문서에 특성을 사용할 수 있는지 또는 반드시 사용해야 하는지를 결정합니다.

Use 특성: XML 스키마 문서에서 소스 코드 생성

Xsd.exe에서 use 특성의 optional 값을 해석하는 방법은 기본 특성 값이 default 특성을 통해 지정되었는지 여부에 따라 다릅니다. optional 및 default 조합을 포함하여 use 특성에 사용할 수 있는 값과 해당하는 Xsd.exe 출력은 다음과 같습니다.

• required: Xsd.exe에서 System.Xml.Serialization.XmlAttributeAttribute를 사용하여 public 필드를 생성합니다.

• default와 함께 optional이 지정됨: Xsd.exe는 XmlAttributeAttribute와 기본값을 지정하는 System.Component.DefaultValueAttribute를 갖는 public 필드를 생성합니다.

• default 없이 optional이 지정됨: Xsd.exe는 XmlAttributeAttribute를 갖는 public 필드를 생성합니다. 또한 특성의 형식이 참조 형식(예: 문자열)이 아니면 특성 필드 이름에 Specified가 추가된 이름을 갖는 bool 형식의 public 필드를 생성합니다. 예를 들어, 특성 필드 이름이 startDate인 경우 bool 필드 이름은 startDateSpecified가 됩니다. 개체를 XML로 serialize할 때 XmlSerializer 클래스는 bool 필드의 값을 확인하여 선택적 특성을 쓸지 여부를 결정합니다. bool 필드는 XmlSerializer가 serialize되지 않도록 System.Xml.Serialization.XmlIgnoreAttribute로 표시됩니다.

• prohibited: Xsd.exe에서 아무것도 생성하지 않습니다.

Use 특성: 클래스에서 XML 스키마 문서 생성

다음 두 경우 중 하나인 경우, Xsd.exe는 use 특성을 지정하지 않고 기본값인 optional로 되돌립니다.

• Specified 명명 규칙을 따르는 추가 공용 bool 필드가 있습니다.

• 기본값이 System.Component.DefaultValueAttribute 형식의 특성을 통해 멤버에 할당됩니다.

두 조건 중 어디에도 해당되지 않으면, Xsd.exe는 use 특성에 대해 required 값을 생성합니다.

예제: Use 특성

입력 XML 스키마 복합 형식:

<xsd:complexType name="Numbers">
  <xsd:attribute name="optionalNumber" type="xsd:int" use="optional"/>
  <xsd:attribute name="requiredNumber" type="xsd:int" use="required"/>
  <xsd:attribute name="prohibitedNumber" type="xsd:int" use="prohibited"/>
</xsd:complexType>

앞의 복합 형식에서 생성된 C# 클래스:

[System.Xml.Serialization.XmlTypeAttribute(Namespace="http://example.org/")]
[System.Xml.Serialization.XmlRootAttribute(Namespace="http://example.org/", IsNullable=false)]
public class Numbers {
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public int optionalNumber;
        
    [System.Xml.Serialization.XmlIgnoreAttribute()]
    public bool optionalNumberSpecified;
        
    [System.Xml.Serialization.XmlAttributeAttribute()]
    public int requiredNumber;
}

앞의 C# 클래스에서 생성된 복합 형식은 원래 복합 형식과 사실상 동일합니다.

[System.ComponentModel.DefaultValueAttribute(-1)]
[System.Xml.Serialization.XmlAttributeAttribute()]
public int age = -1;

[System.Xml.Serialization.XmlAttribute()]
public in age = -1;

가능한 부모 요소: <attributeGroup>, <complexType>, <extension>, <restriction>, <schema>

가능한 자식 요소: <annotation>, <simpleType>

참고 항목

참조

XmlSchemaAttribute