CodeDomSerializer 클래스

정의

개체 그래프를 일련의 CodeDOM 문으로 직렬화합니다. 이 클래스는 serializer에 대한 추상 기본 클래스를 제공합니다.

public ref class CodeDomSerializer abstract
public ref class CodeDomSerializer : System::ComponentModel::Design::Serialization::CodeDomSerializerBase
public abstract class CodeDomSerializer
public class CodeDomSerializer : System.ComponentModel.Design.Serialization.CodeDomSerializerBase
type CodeDomSerializer = class
type CodeDomSerializer = class
    inherit CodeDomSerializerBase
Public MustInherit Class CodeDomSerializer
Public Class CodeDomSerializer
Inherits CodeDomSerializerBase
상속
CodeDomSerializer
상속
CodeDomSerializer
파생

예제

다음 코드 예제에서는 파생 되는 사용자 지정 CodeDOM serializer를 만드는 방법을 보여 줍니다 CodeDomSerializer.

#using <System.Drawing.dll>
#using <System.dll>
#using <System.Design.dll>

using namespace System;
using namespace System::CodeDom;
using namespace System::ComponentModel;
using namespace System::ComponentModel::Design;
using namespace System::ComponentModel::Design::Serialization;
using namespace System::Drawing;
using namespace System::Windows::Forms;

namespace CodeDomSerializerSample
{
   ref class MyComponent;
   private ref class MyCodeDomSerializer: public CodeDomSerializer
   {
   public:
      Object^ Deserialize( IDesignerSerializationManager^ manager, Object^ codeObject ) new
      {
         // This is how we associate the component with the serializer.
         CodeDomSerializer^ baseClassSerializer = (CodeDomSerializer^)(
            manager->GetSerializer(
               MyComponent::typeid->BaseType, CodeDomSerializer::typeid ));
         
         /* This is the simplest case, in which the class just calls the base class
            to do the work. */
         return baseClassSerializer->Deserialize( manager, codeObject );
      }

      Object^ Serialize( IDesignerSerializationManager^ manager, Object^ value ) new
      {
         /* Associate the component with the serializer in the same manner as with
            Deserialize */
         CodeDomSerializer^ baseClassSerializer = (CodeDomSerializer^)(
            manager->GetSerializer(
               MyComponent::typeid->BaseType, CodeDomSerializer::typeid ));

         Object^ codeObject = baseClassSerializer->Serialize( manager, value );
         
         /* Anything could be in the codeObject.  This sample operates on a
            CodeStatementCollection. */
         if ( (CodeStatementCollection^)(codeObject) )
         {
            CodeStatementCollection^ statements = (CodeStatementCollection^)(codeObject);
            
            // The code statement collection is valid, so add a comment.
            String^ commentText = "This comment was added to this object by a custom serializer.";
            CodeCommentStatement^ comment = gcnew CodeCommentStatement( commentText );
            statements->Insert( 0, comment );
         }
         return codeObject;
      }
   };

   [DesignerSerializer(CodeDomSerializerSample::MyCodeDomSerializer::typeid,
      CodeDomSerializer::typeid)]
   public ref class MyComponent: public Component
   {
   private:
      String^ localProperty;

   public:
      MyComponent()
      {
         localProperty = "Component Property Value";
      }

      property String^ LocalProperty 
      {
         String^ get()
         {
            return localProperty;
         }
         void set( String^ value )
         {
            localProperty = value;
         }
      }
   };
}
using System;
using System.CodeDom;
using System.ComponentModel;
using System.ComponentModel.Design;
using System.ComponentModel.Design.Serialization;
using System.Drawing;
using System.Windows.Forms;
 
namespace CodeDomSerializerSample
{
    internal class MyCodeDomSerializer : CodeDomSerializer {
        public override object Deserialize(IDesignerSerializationManager manager, object codeObject) {
            // This is how we associate the component with the serializer.
                CodeDomSerializer baseClassSerializer = (CodeDomSerializer)manager.
                GetSerializer(typeof(MyComponent).BaseType, typeof(CodeDomSerializer));

            /* This is the simplest case, in which the class just calls the base class
                to do the work. */
            return baseClassSerializer.Deserialize(manager, codeObject);
        }
 
        public override object Serialize(IDesignerSerializationManager manager, object value) {
            /* Associate the component with the serializer in the same manner as with
                Deserialize */
            CodeDomSerializer baseClassSerializer = (CodeDomSerializer)manager.
                GetSerializer(typeof(MyComponent).BaseType, typeof(CodeDomSerializer));
 
            object codeObject = baseClassSerializer.Serialize(manager, value);
 
            /* Anything could be in the codeObject.  This sample operates on a
                CodeStatementCollection. */
            if (codeObject is CodeStatementCollection) {
                CodeStatementCollection statements = (CodeStatementCollection)codeObject;
 
                // The code statement collection is valid, so add a comment.
                string commentText = "This comment was added to this object by a custom serializer.";
                CodeCommentStatement comment = new CodeCommentStatement(commentText);
                statements.Insert(0, comment);
            }
            return codeObject;
        }
    }
 
    [DesignerSerializer(typeof(MyCodeDomSerializer), typeof(CodeDomSerializer))]
    public class MyComponent : Component {
        private string localProperty = "Component Property Value";
        public string LocalProperty {
            get {
                return localProperty;
            }
            set {
                localProperty = value;
            }
        }
    }
}
Imports System.CodeDom
Imports System.ComponentModel
Imports System.ComponentModel.Design
Imports System.ComponentModel.Design.Serialization
Imports System.Drawing
Imports System.Windows.Forms

Namespace CodeDomSerializerSample
   Friend Class MyCodeDomSerializer
      Inherits CodeDomSerializer

      Public Overrides Function Deserialize(ByVal manager As IDesignerSerializationManager, _
                                                ByVal codeObject As Object) As Object
         ' This is how we associate the component with the serializer.
         Dim baseClassSerializer As CodeDomSerializer = CType(manager.GetSerializer( _
                GetType(MyComponent).BaseType, GetType(CodeDomSerializer)), CodeDomSerializer)

         ' This is the simplest case, in which the class just calls the base class
         '  to do the work. 
         Return baseClassSerializer.Deserialize(manager, codeObject)
      End Function 'Deserialize

      Public Overrides Function Serialize(ByVal manager As IDesignerSerializationManager, _
                                            ByVal value As Object) As Object
         ' Associate the component with the serializer in the same manner as with
         '  Deserialize
         Dim baseClassSerializer As CodeDomSerializer = CType(manager.GetSerializer( _
                GetType(MyComponent).BaseType, GetType(CodeDomSerializer)), CodeDomSerializer)

         Dim codeObject As Object = baseClassSerializer.Serialize(manager, value)

         ' Anything could be in the codeObject.  This sample operates on a
         '  CodeStatementCollection.
         If TypeOf codeObject Is CodeStatementCollection Then
            Dim statements As CodeStatementCollection = CType(codeObject, CodeStatementCollection)

            ' The code statement collection is valid, so add a comment.
            Dim commentText As String = "This comment was added to this object by a custom serializer."
            Dim comment As New CodeCommentStatement(commentText)
            statements.Insert(0, comment)
         End If
         Return codeObject
      End Function 'Serialize
   End Class

   <DesignerSerializer(GetType(MyCodeDomSerializer), GetType(CodeDomSerializer))> _
   Public Class MyComponent
      Inherits Component
      Private localProperty As String = "Component Property Value"

      Public Property LocalProp() As String
         Get
            Return localProperty
         End Get
         Set(ByVal Value As String)
            localProperty = Value
         End Set
      End Property
   End Class

End Namespace

설명

디자인 타임에 구성 요소 형식에 대한 구성 요소 초기화 코드 생성을 제어하는 사용자 지정 CodeDomSerializer 을 구현할 수 있습니다.

형식에 대한 사용자 지정 CodeDomSerializer 을 구현하려면 다음을 수행해야 합니다.

  1. 에서 CodeDomSerializer파생되는 클래스를 정의합니다.

  2. serialization 또는 deserialization 메서드에 대한 메서드 재정의를 구현합니다. 자세한 내용은 아래 정보를 참조하세요.

  3. 를 사용하여 사용자 지정 CodeDomSerializer 구현을 구성 요소 유형과 연결합니다 DesignerSerializerAttribute.

구성 요소에 대한 구성 코드를 생성하기 위한 serialization 메서드를 구현하려면 다음을 수행합니다.

  1. 파생 CodeDomSerializer되는 클래스 내에서 기본 클래스의 적절한 serialization 또는 deserialization 메서드를 재정의합니다.

  2. 기본 serializer가 기본 구성 요소 구성을 수행하는 코드 문을 생성하도록 하려면 구성 요소에 대한 기본 serializer를 가져와서 호출해야 합니다. 구성 요소에 대한 기본 serializer를 가져오려면 메서드 재정의 GetSerializer 에 전달된 메서드를 호출 IDesignerSerializationManager 합니다. GetSerializer 요청하는 serializer의 기본 형식과 함께 구성 요소를 직렬화할 구성 요소의 형식을 메서드에 CodeDomSerializer전달합니다. 메서드 재정의에 전달된 개체를 사용하여 IDesignerSerializationManager 기본 serializer에서 재정의하는 동일한 이름의 메서드를 호출합니다. 메서드 Serialize 를 구현하는 Serialize 경우 기본 serializer의 메서드는 개체를 반환합니다. 이 개체의 형식은 값을 직렬화하는 구성 요소의 형식에 따라 달라지는 기본 serializer의 형식에 따라 달라집니다. 또는 SerializeEventsSerializeProperties메서드를 구현하는 SerializePropertiesToResources경우 생성된 코드 문을 포함할 새 CodeStatementCollection 코드를 만들어 메서드에 전달해야 합니다.

  3. 기본 serializer 메서드 CodeStatementCollection 를 호출한 경우 구성 요소를 초기화하기 위해 생성할 문이 들어 있는 것입니다. 그렇지 않으면 .를 CodeStatementCollection만들어야 합니다. 구성 요소 구성 코드에서 생성할 문을 나타내는 개체를 이 컬렉션에 추가할 CodeStatement 수 있습니다.

  4. CodeStatementCollection 구성 요소를 구성하기 위해 생성할 소스 코드를 나타내는 값을 반환합니다.

구현자 참고

상속 CodeDomSerializer하는 경우 다음 멤버 Deserialize(IDesignerSerializationManager, Object)Serialize(IDesignerSerializationManager, Object)를 재정의해야 합니다.

생성자

Name Description
CodeDomSerializer()

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

메서드

Name Description
Deserialize(IDesignerSerializationManager, Object)

지정된 직렬화된 CodeDOM 개체를 개체로 역직렬화합니다.

DeserializeExpression(IDesignerSerializationManager, String, CodeExpression)

지정된 식을 역직렬화합니다.

DeserializeExpression(IDesignerSerializationManager, String, CodeExpression)

지정된 식을 메모리 내 개체로 역직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
DeserializeInstance(IDesignerSerializationManager, Type, Object[], String, Boolean)

지정된 형식의 인스턴스를 반환합니다.

(다음에서 상속됨 CodeDomSerializerBase)
DeserializePropertiesFromResources(IDesignerSerializationManager, Object, Attribute[])

필터가 지정된 경우 지정된 필터와 일치하는 지정된 개체의 속성을 역직렬화합니다.

DeserializePropertiesFromResources(IDesignerSerializationManager, Object, Attribute[])

고정 문화권의 리소스 번들에서 지정된 개체의 속성을 역직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
DeserializeStatement(IDesignerSerializationManager, CodeStatement)

지정된 문을 역직렬화합니다.

DeserializeStatement(IDesignerSerializationManager, CodeStatement)

CodeDOM 문을 해석하고 실행하여 문을 역직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
DeserializeStatementToInstance(IDesignerSerializationManager, CodeStatement)

단일 문을 역직렬화합니다.

Equals(Object)

지정된 개체가 현재 개체와 같은지 여부를 확인합니다.

(다음에서 상속됨 Object)
GetExpression(IDesignerSerializationManager, Object)

지정된 개체에 대한 식을 반환합니다.

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

기본 해시 함수로 사용됩니다.

(다음에서 상속됨 Object)
GetSerializer(IDesignerSerializationManager, Object)

지정된 개체 값에 대한 serializer를 찾습니다.

(다음에서 상속됨 CodeDomSerializerBase)
GetSerializer(IDesignerSerializationManager, Type)

지정된 형식에 대한 serializer를 찾습니다.

(다음에서 상속됨 CodeDomSerializerBase)
GetTargetComponentName(CodeStatement, CodeExpression, Type)

지정된 문이 속해야 하는 문 그룹을 결정합니다.

GetType()

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

(다음에서 상속됨 Object)
GetUniqueName(IDesignerSerializationManager, Object)

지정된 개체의 고유한 이름을 반환합니다.

(다음에서 상속됨 CodeDomSerializerBase)
IsSerialized(IDesignerSerializationManager, Object, Boolean)

지정된 개체가 직렬화되었는지 여부를 나타내는 값을 반환하며 선택적으로 미리 설정된 식을 고려합니다.

(다음에서 상속됨 CodeDomSerializerBase)
IsSerialized(IDesignerSerializationManager, Object)

지정된 개체가 serialize되었는지 여부를 나타내는 값을 반환합니다.

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

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

(다음에서 상속됨 Object)
Serialize(IDesignerSerializationManager, Object)

지정된 개체를 CodeDOM 개체로 serialize합니다.

SerializeAbsolute(IDesignerSerializationManager, Object)

기본값을 고려하여 지정된 개체를 직렬화합니다.

SerializeCreationExpression(IDesignerSerializationManager, Object, Boolean)

지정된 개체의 생성을 나타내는 식을 반환합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeEvent(IDesignerSerializationManager, CodeStatementCollection, Object, EventDescriptor)

지정된 이벤트를 지정된 문 컬렉션으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeEvents(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 개체의 모든 이벤트를 serialize합니다.

SerializeEvents(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 이벤트를 지정된 문 컬렉션으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeMember(IDesignerSerializationManager, Object, MemberDescriptor)

지정된 개체에서 지정된 멤버를 serialize합니다.

SerializeMemberAbsolute(IDesignerSerializationManager, Object, MemberDescriptor)

기본값을 고려하여 지정된 멤버를 직렬화합니다.

SerializeProperties(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 필터를 사용하여 지정된 개체의 모든 속성을 serialize합니다.

SerializeProperties(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 개체의 속성을 지정된 문 컬렉션으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializePropertiesToResources(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 속성을 리소스로 직렬화합니다.

SerializePropertiesToResources(IDesignerSerializationManager, CodeStatementCollection, Object, Attribute[])

지정된 개체의 속성을 고정 문화권의 리소스 번들로 직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeProperty(IDesignerSerializationManager, CodeStatementCollection, Object, PropertyDescriptor)

지정된 개체의 속성을 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeResource(IDesignerSerializationManager, String, Object)

지정된 리소스 이름을 사용하여 지정된 개체를 리소스 번들로 직렬화합니다.

SerializeResource(IDesignerSerializationManager, String, Object)

지정된 리소스 이름을 사용하여 지정된 개체를 리소스 번들로 직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeResourceInvariant(IDesignerSerializationManager, String, Object)

고정 문화권을 사용하여 지정된 리소스 이름을 사용하여 지정된 개체를 리소스 번들로 직렬화합니다.

SerializeResourceInvariant(IDesignerSerializationManager, String, Object)

지정된 리소스 이름을 사용하여 지정된 개체를 리소스 번들로 직렬화합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeToExpression(IDesignerSerializationManager, Object)

지정된 값을 CodeDOM 식으로 serialize합니다.

SerializeToExpression(IDesignerSerializationManager, Object)

지정된 개체를 식으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeToReferenceExpression(IDesignerSerializationManager, Object)
사용되지 않음.
사용되지 않음.

지정된 값을 CodeDOM 식으로 serialize합니다.

SerializeToResourceExpression(IDesignerSerializationManager, Object, Boolean)

지정된 개체를 고정 문화권에 적합한 식으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SerializeToResourceExpression(IDesignerSerializationManager, Object)

지정된 개체를 식으로 serialize합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SetExpression(IDesignerSerializationManager, Object, CodeExpression, Boolean)

선택적으로 미리 설정된 식을 지정하여 개체를 식과 연결합니다.

(다음에서 상속됨 CodeDomSerializerBase)
SetExpression(IDesignerSerializationManager, Object, CodeExpression)

개체를 식과 연결합니다.

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

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

(다음에서 상속됨 Object)

적용 대상

추가 정보