CodeDomSerializer クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクト グラフを一連の CodeDOM ステートメントにシリアル化します。 このクラスは、シリアライザーの抽象基本クラスを提供します。
public ref class CodeDomSerializer abstractpublic ref class CodeDomSerializer : System::ComponentModel::Design::Serialization::CodeDomSerializerBasepublic abstract class CodeDomSerializerpublic class CodeDomSerializer : System.ComponentModel.Design.Serialization.CodeDomSerializerBasetype CodeDomSerializer = classtype CodeDomSerializer = class
inherit CodeDomSerializerBasePublic MustInherit Class CodeDomSerializerPublic Class CodeDomSerializer
Inherits CodeDomSerializerBase- 継承
-
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 を実装するには、次の操作を行う必要があります。
CodeDomSerializerから派生するクラスを定義します。
シリアル化または逆シリアル化メソッドのメソッドオーバーライドを実装します。 (詳細については、以下の情報を参照してください。
DesignerSerializerAttributeを使用して、カスタム CodeDomSerializer実装をコンポーネントの種類に関連付けます。
コンポーネントの構成コードを生成するためのシリアル化メソッドを実装するには:
CodeDomSerializerから派生するクラス内で、基底クラスの適切なシリアル化または逆シリアル化メソッドをオーバーライドします。
既定のシリアライザーで既定のコンポーネント構成を実行するコード ステートメントを生成する場合は、コンポーネントの基本シリアライザーを取得して呼び出す必要があります。 コンポーネントの基本シリアライザーを取得するには、メソッドオーバーライドに渡されたIDesignerSerializationManagerのGetSerializerメソッドを呼び出します。 構成をシリアル化するコンポーネントの型 GetSerializer メソッドと、要求するシリアライザーの基本型 ( CodeDomSerializer) を渡します。 基本シリアライザーでオーバーライドするのと同じ名前のメソッドを、メソッドオーバーライドに渡された IDesignerSerializationManager とオブジェクトを使用して呼び出します。 Serialize メソッドを実装している場合、基本シリアライザーのSerialize メソッドはオブジェクトを返します。 このオブジェクトの型は、値をシリアル化するコンポーネントの型に依存する基本シリアライザーの型によって異なります。 SerializeEvents、SerializeProperties、またはSerializePropertiesToResourcesメソッドを実装する場合は、生成されたコード ステートメントを含む新しいCodeStatementCollectionを作成し、メソッドに渡す必要があります。
基本シリアライザー メソッドを呼び出した場合は、コンポーネントを初期化するために生成するステートメントを含む CodeStatementCollection があります。 それ以外の場合は、 CodeStatementCollectionを作成する必要があります。 コンポーネント構成コードで生成 CodeStatement ステートメントを表すオブジェクトをこのコレクションに追加できます。
コンポーネントを構成するために生成するソース コードを表す CodeStatementCollection を返します。
注意 (実装者)
CodeDomSerializerから継承する場合は、次のメンバーをオーバーライドする必要があります: Deserialize(IDesignerSerializationManager, Object)とSerialize(IDesignerSerializationManager, Object)。
コンストラクター
| 名前 | 説明 |
|---|---|
| CodeDomSerializer() |
CodeDomSerializer クラスの新しいインスタンスを初期化します。 |