DesignerSerializationManager.RecycleInstances Tulajdonság

Definíció

Névtér:

System.ComponentModel.Design.Serialization

Szerelvény:

System.Windows.Forms.Design.dll

Forrás:

DesignerSerializationManager.cs

Lekéri vagy beállít egy értéket, amely jelzi, hogy mindig létrehoz-e CreateInstance(Type, ICollection, String, Boolean) új típusú példányt.

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

Tulajdonság értéke

Boolean

true ha CreateInstance(Type, ICollection, String, Boolean) a meglévő példányt adja vissza; false ha CreateInstance(Type, ICollection, String, Boolean) egy új típusú példányt hoz létre. Az alapértelmezett érték a false.

Kivételek

InvalidOperationException

A szerializálás-kezelő aktív szerializálási munkamenetet kapott.

Megjegyzések

Ha a RecycleInstances tulajdonság az false, a CreateInstance metódus mindig létrehoz egy új típusú példányt. Ha RecycleInstances igen true, CreateInstance először a névtáblában és a tárolóban keres egy azonos nevű objektumot. Ha egy ilyen objektum létezik, és azonos típusú, CreateInstance a meglévő példányt adja vissza. Ez a második változat olyan szerializáló implementálásához hasznos, amely szerializálási állapotot alkalmaz egy meglévő objektumkészletre, és nem mindig hoz létre új fát. A Visszavonás parancs gyakran használja az ilyen típusú szerializálót.

Abban az esetben, ha a RecycleInstances tulajdonság az true, a ValidateRecycledTypes tulajdonság tovább módosítja a viselkedését CreateInstance a két objektum típusától függően.

Lásd még

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