CodeDomSerializerBase.SerializeToExpression メソッド

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

CodeDomSerializerBase.SerializeToExpression メソッド

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

指定したオブジェクトを式にシリアル化します。

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

Visual Basic (宣言)

Protected Function SerializeToExpression (
 _
    manager As IDesignerSerializationManager, _
    value As Object _
) As CodeExpression

Visual Basic (使用法)

Dim manager As IDesignerSerializationManager
Dim value As Object
Dim returnValue As CodeExpression

returnValue = Me.SerializeToExpression(manager, value)

C#

protected CodeExpression SerializeToExpression (
    IDesignerSerializationManager manager,
    Object value
)

C++

protected:
CodeExpression^ SerializeToExpression (
    IDesignerSerializationManager^ manager, 
    Object^ value
)

J#

protected CodeExpression SerializeToExpression (
    IDesignerSerializationManager manager, 
    Object value
)

JScript

protected function SerializeToExpression (
    manager : IDesignerSerializationManager, 
    value : Object
) : CodeExpression

パラメータ

manager

シリアル化に使用する IDesignerSerializationManager。

value

シリアル化するオブジェクト。null 参照 (Visual Basic では Nothing) でもかまいません。

戻り値
value をシリアル化できる場合は CodeExpression オブジェクト。それ以外の場合は null 参照 (Visual Basic では Nothing)。

例外

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

解説

value パラメータに null 参照 (Visual Basic では Nothing) を指定できます。この場合プリミティブ式が返されます。

SerializeToExpression メソッドは、型をシリアル化する際に次の規則を使用します。

1. まず、GetExpression メソッドを呼び出して、そのオブジェクトに対して式が既に作成されているかどうかを確認します。式が作成されている場合は、その既存の式を返します。

2. 次に、オブジェクトのシリアライザを検索し、このシリアライザにシリアル化を要求します。

3. オブジェクトのシリアライザの戻り値が CodeExpression の場合は、式が返されます。

4. GetExpression を最後に 1 回呼び出して、シリアライザが式を追加したかどうかを確認します。

5. 最後に、null 参照 (Visual Basic では Nothing) を返します。

式を作成できず、適切なシリアライザが見つからなかった場合、シリアル化マネージャを通じてエラーが報告されます。シリアライザが見つかっても、式を生成できなかった場合は、エラーは報告されません。この場合、シリアライザが既にエラーを報告しているか、オブジェクトのシリアル化を試みなかったことが考えられます。

シリアライザがステートメントまたはステートメントのコレクションを返した場合、これらのステートメントは破棄されません。SerializeToExpression メソッドは、まずコンテキスト スタックで StatementContext を検索し、ステートメントのコンテキスト オブジェクトの StatementCollection プロパティにステートメントを追加します。ステートメントのコンテキストが存在しない場合は、SerializeToExpression メソッドは CodeStatementCollection のコンテキストを検索し、そこにステートメントを追加します。ステートメントの追加先が見つからない場合、エラーが発生します。

メモ
固有のオブジェクトをシリアル化するときに、Serialize 内で SerializeToExpression メソッドを呼び出さないでください。代わりに、GetExpression を呼び出します。null 参照 (Visual Basic では Nothing) が返された場合は、固有の式を作成し、SetExpression を呼び出します。続いて、シリアル化の残りを継続します。

.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

参照

関連項目
CodeDomSerializerBase クラス
CodeDomSerializerBase メンバ
System.ComponentModel.Design.Serialization 名前空間
IDesignerSerializationManager
CodeStatementCollection
CodeExpression
StatementContext
その他の技術情報
動的なソース コードの生成とコンパイル