DesignerSerializationManager.RecycleInstances プロパティ

定義

名前空間:

System.ComponentModel.Design.Serialization

アセンブリ:

System.Windows.Forms.Design.dll

CreateInstance(Type, ICollection, String, Boolean) が型の新しいインスタンスを常に作成するかどうかを示す値が取得または設定されます。

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

public bool RecycleInstances { get; set; }

member this.RecycleInstances : bool with get, set

Public Property RecycleInstances As Boolean

プロパティ値

Boolean

CreateInstance(Type, ICollection, String, Boolean) が既存のインスタンスを返す場合は true。CreateInstance(Type, ICollection, String, Boolean) が型の新しいインスタンスを作成する場合は false。 既定値は、false です。

例外

InvalidOperationException

シリアル化マネージャーに、アクティブなシリアル化セッションが存在します。

注釈

プロパティが RecycleInstances の false場合、 CreateInstance メソッドは常に型の新しいインスタンスを作成します。 が trueのCreateInstance場合RecycleInstancesは、最初に名前テーブルとコンテナーで同じ名前のオブジェクトを検索します。 このようなオブジェクトが存在し、 が同じ型の場合は、 CreateInstance 既存のインスタンスが返されます。 この 2 番目のバリエーションは、常に新しいツリーを作成するのではなく、既存のオブジェクト セットにシリアル化状態を適用するシリアライザーを実装する場合に便利です。 Undo コマンドは、多くの場合、この種類のシリアライザーを使用します。

プロパティが のRecycleInstances場合、 プロパティtrueValidateRecycledTypesは、2 つのオブジェクトのCreateInstance種類に応じて の動作をさらに変更します。

こちらもご覧ください

• CreateInstance(Type, ICollection, String, Boolean)
• ValidateRecycledTypes