C# 클래스 SimpleFramework.Xml.Core.ElementLabel

The ElementLabel represents a label that is used to represent an XML element in a class schema. This element can be used to convert an XML node into either a primitive value such as a string or composite object value, which is itself a schema for a section of XML within the XML document.

상속: Label

파일 보기 프로젝트 열기: ngallagher/simplexml

공개 메소드들

메소드	설명
ElementLabel ( Contact contact, Element label ) : SimpleFramework.Xml.Strategy	Constructor for the `ElementLabel` object. This is used to create a label that can convert a XML node into a composite object or a primitive type from an XML element.
GetConverter ( Context context ) : Converter
GetEmpty ( Context context ) : Object	This is used to provide a configured empty value used when the annotated value is null. This ensures that XML can be created with required details regardless of whether values are null or not. It also provides a means for sensible default values.
GetName ( Context context ) : String	This is used to acquire the name of the element or attribute that is used by the class schema. The name is determined by checking for an override within the annotation. If it contains a name then that is used, if however the annotation does not specify a name the the field or method name is used instead.
IsAttribute ( ) : bool
IsCollection ( ) : bool	This is used to determine if the label is a collection. If the label represents a collection then any original assignment to the field or method can be written to without the need to create a new collection. This allows obscure collections to be used and also allows initial entries to be maintained.
IsData ( ) : bool	This is used to determine whether the annotation requires it and its children to be written as a CDATA block. This is done when a primitive or other such element requires a text value and that value needs to be encapsulated within a CDATA block.
IsInline ( ) : bool	This method is used by the deserialization process to check to see if an annotation is inline or not. If an annotation represents an inline XML entity then the deserialization and serialization process ignores overrides and special attributes. By default all XML elements are not inline.
IsRequired ( ) : bool	This is used to determine whether the XML element is required. This ensures that if an XML element is missing from a document that deserialization can continue. Also, in the process of serialization, if a value is null it does not need to be written to the resulting XML document.
ToString ( ) : String	This is used to describe the annotation and method or field that this label represents. This is used to provide error messages that can be used to debug issues that occur when processing a method. This will provide enough information such that the problem can be isolated correctly.

메소드 상세

ElementLabel() 공개 메소드

Constructor for the ElementLabel object. This is used to create a label that can convert a XML node into a composite object or a primitive type from an XML element.

public ElementLabel ( Contact contact, Element label ) : SimpleFramework.Xml.Strategy
contact	Contact	/// this is the field that this label represents ///
label	SimpleFramework.Xml.Element	/// this is the annotation for the contact ///
리턴	SimpleFramework.Xml.Strategy

GetConverter() 공개 메소드

public GetConverter ( Context context ) : Converter
context	Context	/// this is the context object used for serialization ///
리턴	Converter

GetEmpty() 공개 메소드

This is used to provide a configured empty value used when the annotated value is null. This ensures that XML can be created with required details regardless of whether values are null or not. It also provides a means for sensible default values.

public GetEmpty ( Context context ) : Object
context	Context	/// this is the context object for the serialization ///
리턴	Object

GetName() 공개 메소드

This is used to acquire the name of the element or attribute that is used by the class schema. The name is determined by checking for an override within the annotation. If it contains a name then that is used, if however the annotation does not specify a name the the field or method name is used instead.

public GetName ( Context context ) : String
context	Context	/// this is used to provide a styled name ///
리턴	String

IsAttribute() 공개 메소드

public IsAttribute ( ) : bool
리턴	bool

IsCollection() 공개 메소드

This is used to determine if the label is a collection. If the label represents a collection then any original assignment to the field or method can be written to without the need to create a new collection. This allows obscure collections to be used and also allows initial entries to be maintained.

public IsCollection ( ) : bool
리턴	bool

IsData() 공개 메소드

This is used to determine whether the annotation requires it and its children to be written as a CDATA block. This is done when a primitive or other such element requires a text value and that value needs to be encapsulated within a CDATA block.

public IsData ( ) : bool
리턴	bool

IsInline() 공개 메소드

This method is used by the deserialization process to check to see if an annotation is inline or not. If an annotation represents an inline XML entity then the deserialization and serialization process ignores overrides and special attributes. By default all XML elements are not inline.

public IsInline ( ) : bool
리턴	bool

IsRequired() 공개 메소드

This is used to determine whether the XML element is required. This ensures that if an XML element is missing from a document that deserialization can continue. Also, in the process of serialization, if a value is null it does not need to be written to the resulting XML document.

public IsRequired ( ) : bool
리턴	bool

ToString() 공개 메소드

This is used to describe the annotation and method or field that this label represents. This is used to provide error messages that can be used to debug issues that occur when processing a method. This will provide enough information such that the problem can be isolated correctly.

public ToString ( ) : String
리턴	String