TypeCodeDomSerializer.Serialize メソッド

.NET Framework クラス ライブラリ リファレンス

TypeCodeDomSerializer.Serialize メソッド

メモ : このメソッドは、.NET Framework version 2.0 で新しく追加されたものです。

ルートを定義する新しい型宣言を作成することによって、オブジェクト ルートをシリアル化します。

名前空間: System.ComponentModel.Design.Serialization
アセンブリ: System.Design (system.design.dll 内)
構文

Visual Basic (宣言)

Public Overridable Function
 Serialize ( _
    manager As IDesignerSerializationManager, _
    root As Object, _
    members As ICollection _
) As CodeTypeDeclaration

Visual Basic (使用法)

Dim instance As TypeCodeDomSerializer
Dim manager As IDesignerSerializationManager
Dim root As Object
Dim members As ICollection
Dim returnValue As CodeTypeDeclaration

returnValue = instance.Serialize(manager, root, members)

C#

public virtual CodeTypeDeclaration Serialize (
    IDesignerSerializationManager manager,
    Object root,
    ICollection members
)

C++

public:
virtual CodeTypeDeclaration^ Serialize (
    IDesignerSerializationManager^ manager, 
    Object^ root, 
    ICollection^ members
)

J#

public CodeTypeDeclaration Serialize (
    IDesignerSerializationManager manager, 
    Object root, 
    ICollection members
)

JScript

public function Serialize (
    manager : IDesignerSerializationManager, 
    root : Object, 
    members : ICollection
) : CodeTypeDeclaration

パラメータ

manager

シリアル化に使用するシリアル化マネージャ。

root

シリアル化するオブジェクト。

members

省略可能なメンバのコレクション。null 参照 (Visual Basic では Nothing) または空になる場合があります。

戻り値
ルート オブジェクトを定義する CodeTypeDeclaration。

例外

例外の種類	条件
ArgumentNullException	manager または root が null 参照 (Visual Basic では Nothing) です。

解説

Serialize メソッドは、新しい型定義を作成するために、指定したルート オブジェクトおよび省略可能なメンバのコレクションをシリアル化します。members コレクションに値が含まれている場合は、これらの値がシリアル化されます。値自体は、メンバ変数またはローカル変数としてシリアル化します。どちらになるかは、GenerateMember という名前のオブジェクトのエクステンダ プロパティを検索して決定されます。true の場合、メンバが生成されます。それ以外の場合は、ローカル変数が生成されます。便宜上、members コレクションにはルート オブジェクトを格納できます。この場合、ルート オブジェクトもメンバまたはローカル変数として追加されることはありません。

返される型の名前は、ルート オブジェクトが名前付きオブジェクトである場合、その名前から取得されます。名前付きオブジェクトでない場合、名前はルート クラスの単純型名から生成されます。

Serialize メソッドの既定の実装によって実行されるタスクを次の表に示します。

タスク	説明
コンテキストのシード	シリアル化コンテキストは、RootContext および CodeTypeDeclaration を含むデータを使用して初期化されます。
メンバのシリアル化	次に、Serialize は、すべてのメンバをウォークし、SerializeToExpression を呼び出します。シリアル化は SerializeToExpression で便宜的に行われるため、シリアル化が 2 回行われることはありません。
ルートのシリアル化	次に、ルート オブジェクトがシリアル化され、そのステートメントがステートメント コレクションに追加されます。
ステートメントの統合	すべてのオブジェクトがシリアル化された後、Serialize メソッドは、ステートメントの順序付けを行い、これらを GetInitializeMethod から返されたメソッドに追加します。最後に、GetInitializeMethod から返されたすべてのメソッドを呼び出すコンストラクタが生成されます。

Serialize メソッドがコンテキスト スタックに配置するオブジェクトを次の表に示します。

インスタンス	説明
TypeCodeDomSerializer	このシリアライザ。派生クラスでは、このクラスにパブリック プロパティを追加すると便利な場合があります。
CodeTypeDeclaration	作成されている型。ほとんどのオブジェクトは、この型に直接アクセスする必要はありません。

.NET Framework のセキュリティ

• 直前の呼び出し元に対する完全な信頼。このメンバは、部分的に信頼されているコードから使用することはできません。詳細については、「」を参照してください。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0

参照

関連項目
TypeCodeDomSerializer クラス
TypeCodeDomSerializer メンバ
System.ComponentModel.Design.Serialization 名前空間
CodeDomSerializer クラス
IDesignerSerializationManager インターフェイス
System.CodeDom.Compiler.CodeDomProvider
System.CodeDom.CodeTypeDeclaration
その他の技術情報
動的なソース コードの生成とコンパイル