XmlIgnoreAttribute 클래스

  • 참조

정의

네임스페이스:
System.Xml.Serialization
어셈블리:
System.Xml.XmlSerializer.dll
어셈블리:
System.Xml.ReaderWriter.dll
어셈블리:
System.Xml.dll
어셈블리:
netstandard.dll

Serialize(TextWriter, Object)의 XmlSerializer 메서드를 호출하여 공용 필드 또는 공용 읽기/쓰기 속성 값을 serialize하지 않도록 합니다.

public ref class XmlIgnoreAttribute : Attribute
[System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)]
public class XmlIgnoreAttribute : Attribute
[<System.AttributeUsage(System.AttributeTargets.Field | System.AttributeTargets.Parameter | System.AttributeTargets.Property | System.AttributeTargets.ReturnValue)>]
type XmlIgnoreAttribute = class
    inherit Attribute
Public Class XmlIgnoreAttribute
Inherits Attribute
상속
Object
Attribute
XmlIgnoreAttribute
특성
AttributeUsageAttribute

예제

다음 예제에서는 이름이 Comment지정된 필드를 포함하는 클래스Group를 보여 줍니다. 이 예제에서는 필드에 할당 XmlIgnoreAttribute 하므로 클래스 인스턴스를 직렬화하거나 역직렬화할 때 필드를 무시하도록 지시 XmlSerializer 합니다.

public ref class Group
{
public:

   // The XmlSerializer ignores this field.

   [XmlIgnore]
   String^ Comment;

   // The XmlSerializer serializes this field.
   String^ GroupName;
};

public class Group
{
   // The XmlSerializer ignores this field.
   [XmlIgnore]
   public string Comment;

   // The XmlSerializer serializes this field.
   public string GroupName;
}

Public Class Group
    ' the XmlSerializer ignores this field.
    <XmlIgnore()> Public Comment As String
    
    ' The XmlSerializer serializes this field.
    Public GroupName As String
End Class

설명

개체 XmlIgnoreAttribute 를 직렬화하거나 역직렬화하는 방법을 XmlSerializer 제어하는 특성 패밀리에 속합니다. 클래스의 멤버에 XmlIgnoreAttribute 적용하는 경우 클래스 XmlSerializer 의 인스턴스를 직렬화하거나 역직렬화할 때 멤버를 무시합니다. 유사한 특성의 전체 목록은 XML Serialization을 제어하는 특성을 참조하세요.

개체를 만들고 XmlAttributes 해당 XmlIgnore 속성을 .로 설정하여 발생하는 XmlIgnoreAttribute 동작을 재정의할 false수 있습니다. 클래스의 XmlAttributes 인스턴스 XmlAttributeOverrides 에 대한 개체여야 합니다Add. 마지막으로, 메서드를 XmlAttributeOverrides Deserialize 호출하기 전에 개체를 사용하여 클래스의 XmlSerializer 인스턴스를 Serialize 생성해야 합니다.

XML 스키마 정의 도구(Xsd.exe)는 스키마 파일(.xsd)에서 클래스를 만들 때 가끔 생성 XmlIgnoreAttribute 합니다. 이 동작은 값 형식을 설정할 null수 없지만 모든 XML 데이터 형식이 될 수 있기 때문에 발생합니다. 따라서 도구는 값 형식에 매핑되는 XML 형식을 발견할 때 두 개의 필드를 만듭니다. 하나는 값을 보유하는 필드이고 다른 하나는 형식을 사용하는 fieldnameSpecified특수 필드입니다. 여기서 fieldname 필드 또는 속성의 이름으로 바뀝니다. 그러나 이 특수 필드는 스키마가 요소에 최소 발생(minOccurs = "0")이 없고 요소에 기본값이 없음을 지정하는 경우에만 생성됩니다. 이 XmlSerializer 특수 필드를 설정하고 확인하여 필드 또는 속성에 대한 값이 설정되었는지 여부를 확인합니다. 특수 필드를 직렬화하면 안 되므로 도구가 XmlIgnoreAttribute 해당 필드를 적용합니다.

특성을 사용 하는 방법에 대 한 자세한 내용은 참조 하세요. 특성합니다.

참고

더 긴 XmlIgnoreAttribute대신 코드에서 단어를 XmlIgnore 사용할 수 있습니다.

생성자

XmlIgnoreAttribute()

XmlIgnoreAttribute 클래스의 새 인스턴스를 초기화합니다.

속성

TypeId

파생 클래스에서 구현된 경우 이 Attribute에 대한 고유 식별자를 가져옵니다.

(다음에서 상속됨 Attribute)

메서드

Equals(Object)

이 인스턴스가 지정된 개체와 같은지를 나타내는 값을 반환합니다.

(다음에서 상속됨 Attribute)
GetHashCode()

이 인스턴스의 해시 코드를 반환합니다.

(다음에서 상속됨 Attribute)
GetType()

현재 인스턴스의 Type을 가져옵니다.

(다음에서 상속됨 Object)
IsDefaultAttribute()

파생 클래스에서 재정의된 경우 이 인스턴스 값이 파생 클래스에 대한 기본값인지 여부를 표시합니다.

(다음에서 상속됨 Attribute)
Match(Object)

파생 클래스에서 재정의된 경우 이 인스턴스가 지정된 개체와 같은지 여부를 나타내는 값을 반환합니다.

(다음에서 상속됨 Attribute)
MemberwiseClone()

현재 Object의 단순 복사본을 만듭니다.

(다음에서 상속됨 Object)
ToString()

현재 개체를 나타내는 문자열을 반환합니다.

(다음에서 상속됨 Object)

명시적 인터페이스 구현

_Attribute.GetIDsOfNames(Guid, IntPtr, UInt32, UInt32, IntPtr)

이름 집합을 해당하는 디스패치 식별자 집합에 매핑합니다.

(다음에서 상속됨 Attribute)
_Attribute.GetTypeInfo(UInt32, UInt32, IntPtr)

인터페이스의 형식 정보를 가져오는 데 사용할 수 있는 개체의 형식 정보를 검색합니다.

(다음에서 상속됨 Attribute)
_Attribute.GetTypeInfoCount(UInt32)

개체에서 제공하는 형식 정보 인터페이스의 수를 검색합니다(0 또는 1).

(다음에서 상속됨 Attribute)
_Attribute.Invoke(UInt32, Guid, UInt32, Int16, IntPtr, IntPtr, IntPtr, IntPtr)

개체에서 노출하는 메서드와 속성에 대한 액세스를 제공합니다.

(다음에서 상속됨 Attribute)

적용 대상

추가 정보