내보내기(0) 인쇄
모두 확장
정보
요청한 주제가 아래에 표시됩니다. 그러나 이 주제는 이 라이브러리에 포함되지 않습니다.

XmlArrayAttribute 클래스

2013-12-13

XmlSerializer가 특정 클래스 멤버를 XML 요소의 배열로 직렬화하도록 지정합니다.

System.Object
  System.Attribute
    System.Xml.Serialization.XmlArrayAttribute

Namespace:  System.Xml.Serialization
어셈블리:  System.Xml(System.Xml.dll)

[AttributeUsageAttribute(AttributeTargets.Field|AttributeTargets.Parameter|AttributeTargets.Property|AttributeTargets.ReturnValue, AllowMultiple = false)]
public class XmlArrayAttribute : Attribute

XmlArrayAttribute 형식에서는 다음과 같은 멤버를 노출합니다.

  이름설명
Public 메서드XmlArrayAttribute()XmlArrayAttribute 클래스의 새 인스턴스를 초기화합니다.
Public 메서드XmlArrayAttribute(String)XmlArrayAttribute 클래스의 새 인스턴스를 초기화하며 XML 문서 인스턴스에서 생성된 XML 요소의 이름을 지정합니다.
맨 위

  이름설명
Public 속성ElementName직렬화된 배열에 제공되는 XML 요소 이름을 가져오거나 설정합니다.
Public 속성FormXmlSerializer에서 생성한 XML 요소 이름이 정규화되었는지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성IsNullableXmlSerializer에서 xsi:nil 특성이 true로 설정된 빈 XML 요소로 멤버를 직렬화해야 하는지 여부를 나타내는 값을 가져오거나 설정합니다.
Public 속성NamespaceXML 요소의 네임스페이스를 가져오거나 설정합니다.
Public 속성Order요소가 직렬화 또는 역직렬화되는 명시적 순서를 가져오거나 설정합니다.
맨 위

  이름설명
Public 메서드Equals인프라입니다. 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드Finalize가비지 수집기에서 Object를 회수하기 전에 개체가 리소스를 해제하고 다른 정리 작업을 수행할 수 있게 합니다. (Object에서 상속됨)
Public 메서드GetHashCode해당 인스턴스에 대한 해시 코드를 반환합니다. (Attribute에서 상속됨)
Public 메서드GetType현재 인스턴스의 Type을 가져옵니다. (Object에서 상속됨)
Public 메서드Match파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다. (Attribute에서 상속됨)
Protected 메서드MemberwiseClone현재 Object의 단순 복사본을 만듭니다. (Object에서 상속됨)
Public 메서드ToString현재 개체를 나타내는 문자열을 반환합니다. (Object에서 상속됨)
맨 위

XmlSerializer가 개체를 직렬화 및 역렬화하는 방식을 제어하는 특성 패밀리에 속한 XmlArrayAttribute입니다.

개체, 컬렉션, 또는 IEnumerable 인터페이스를 구현하는 모든 클래스의 배열을 반환하는 공용 필드 또는 읽기/쓰기 속성에 XmlArrayAttribute를 적용할 수 있습니다.

XmlArrayAttribute를 클래스 멤버에 적용하면 XmlSerializer 클래스의 Serialize 메서드가 해당 멤버에서 XML 요소의 중첩된 시퀀스를 생성합니다. XML 스키마 문서(.xsd 파일)는 그러한 배열을 complexType으로 표현합니다. 예를 들어, 직렬화될 클래스가 구매 주문서를 나타내는 경우, 주문 항목을 나타내는 개체로 이루어진 배열을 반환하는 공용 필드에 XmlArrayAttribute를 적용하면 구매한 항목의 배열을 생성할 수 있습니다.

복합 형식 또는 기본 형식 개체로 이루어진 배열을 반환하는 공용 필드나 속성에 특성을 적용하지 않으면 XmlSerializer는 기본적으로 XML 요소의 중첩된 시퀀스를 생성합니다. 생성되는 XML 요소를 더욱 정확히 제어하려면 필드 또는 속성에 XmlArrayItemAttributeXmlArrayAttribute를 적용하세요. 예를 들어, 생성된 XML 요소 이름은 기본적으로 멤버 식별자에서 파생되므로 ElementName 속성을 설정하여 생성된 XML 요소의 이름을 변경할 수 있습니다.

특정한 형식의 항목 및 해당 형식에서 파생된 모든 클래스를 포함하는 배열을 직렬화하는 경우 XmlArrayItemAttribute를 사용하여 각 형식을 선언해야 합니다.

참고참고:

XmlArrayAttribute 대신 XmlArray를 코드에서 사용할 수 있습니다.

Windows Phone OS

지원되는 버전: 8.0, 7.1, 7.0

Windows Phone

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 모든 인스턴스 멤버는 스레드로부터 안전하지 않을 수 있습니다.

표시:
© 2014 Microsoft