DesignerSerializationManager.RecycleInstances プロパティ

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

DesignerSerializationManager.RecycleInstances プロパティ

メモ : このプロパティは、.NET Framework version 2.0 で新しく追加されたものです。

CreateInstance が型の新しいインスタンスを常に作成するかどうかを示すフラグを取得または設定します。

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

Visual Basic (宣言)

Public Property RecycleInstances As
 Boolean

Visual Basic (使用法)

Dim instance As DesignerSerializationManager
Dim value As Boolean

value = instance.RecycleInstances

instance.RecycleInstances = value

C#

public bool RecycleInstances { get;
 set; }

C++

public:
property bool RecycleInstances {
    bool get ();
    void set (bool value);
}

J#

/** @property */
public boolean get_RecycleInstances ()

/** @property */
public void set_RecycleInstances (boolean value)

JScript

public function get RecycleInstances
 () : boolean

public function set RecycleInstances
 (value : boolean)

プロパティ値
CreateInstance が既存のインスタンスを返す場合は true。CreateInstance が型の新しいインスタンスを作成する場合は false。既定値は false です。

例外

例外の種類	条件
InvalidOperationException	シリアル化マネージャに、アクティブなシリアル化セッションが存在します。

解説

RecycleInstances プロパティが false の場合、CreateInstance メソッドは、常に型の新しいインスタンスを作成します。RecycleInstances が true の場合には、CreateInstance はまず名前テーブルとコンテナで同じ名前のオブジェクトを検索します。該当するオブジェクトが存在し、そのオブジェクトが同じ型のオブジェクトの場合、CreateInstance はその既存のインスタンスを返します。この 2 つ目の動作は、常に新しいツリーを作成するのではなく、シリアル化状態を一連の既存のオブジェクトに適用するシリアライザを実装する場合に役立ちます。多くの場合、[元に戻す] コマンドはこの種類のシリアライザを使用します。

RecycleInstances プロパティが true の場合、ValidateRecycledTypes プロパティは、2 つのオブジェクトの型によっては、CreateInstance の動作をさらに変更します。

.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

参照

関連項目
DesignerSerializationManager クラス
DesignerSerializationManager メンバ
System.ComponentModel.Design.Serialization 名前空間
CreateInstance
ValidateRecycledTypes