CodeDomSerializer 클래스

정의

일련의 CodeDOM 문에 개체 그래프를 serialize합니다. 이 클래스는 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
파생

예제

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

#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를 가져오려면 메서드 재정의에 전달된 의 IDesignerSerializationManager 메서드를 호출 GetSerializer 합니다. GetSerializer 요청하려는 serializer의 기본 형식()과 함께 구성 요소를 serialize할 구성 요소의 형식을 메서드에 CodeDomSerializer전달합니다. 메서드 재정의에 전달된 및 개체를 사용하여 IDesignerSerializationManager 기본 직렬 변환기에서 재정의하는 동일한 이름의 메서드를 호출합니다. 메서드 Serialize 를 구현하는 Serialize 경우 기본 serializer의 메서드는 개체를 반환합니다. 이 개체의 형식은 값을 직렬화하는 구성 요소의 형식에 따라 달라지는 기본 직렬 변환기의 형식에 따라 달라집니다. , SerializeProperties또는 SerializePropertiesToResources 메서드를 구현하는 SerializeEvents경우 생성된 코드 문을 포함할 새 CodeStatementCollection 를 만들고 메서드에 전달해야 합니다.

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

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

구현자 참고

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

생성자

CodeDomSerializer()

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

메서드

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)

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

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

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

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

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

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

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

SerializeAbsolute(IDesignerSerializationManager, Object)

지정된 개체를 serialize하여 기본값을 생성합니다.

SerializeCreationExpression(IDesignerSerializationManager, Object, Boolean)

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

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

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

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

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

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

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

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

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

SerializeMemberAbsolute(IDesignerSerializationManager, Object, MemberDescriptor)

기본값을 설명하는 지정된 멤버를 serialize합니다.

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

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

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

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

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

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

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

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

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

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

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

특정 리소스 이름을 사용하여 리소스 번들에 특정 개체를 serialize합니다.

SerializeResource(IDesignerSerializationManager, String, Object)

특정 리소스 이름을 사용하여 리소스 번들에 특정 개체를 serialize합니다.

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

고정 문화권을 사용하는 특정 리소스 이름으로 리소스 번들에 특정 개체를 serialize합니다.

SerializeResourceInvariant(IDesignerSerializationManager, String, Object)

특정 리소스 이름을 사용하여 리소스 번들에 특정 개체를 serialize합니다.

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

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

SerializeToExpression(IDesignerSerializationManager, Object)

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

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

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

SerializeToResourceExpression(IDesignerSerializationManager, Object)

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

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

지정된 개체를 고정 문화권에 알맞은 식에 serialize합니다.

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

개체를 식과 연결합니다.

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

선택적으로 사전 설정 식을 지정하여 개체와 식을 연결합니다.

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

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

(다음에서 상속됨 Object)

적용 대상

추가 정보