DesignerSerializationManager.RecycleInstances Propiedad

Definición

Espacio de nombres:

System.ComponentModel.Design.Serialization

Ensamblado:

System.Windows.Forms.Design.dll

Obtiene o establece un valor que indica si CreateInstance(Type, ICollection, String, Boolean) va a crear siempre una nueva instancia de un tipo.

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

Valor de propiedad

Boolean

true si CreateInstance(Type, ICollection, String, Boolean) va a devolver la instancia existente; false si CreateInstance(Type, ICollection, String, Boolean) va a crear una nueva instancia de un tipo. De manera predeterminada, es false.

Excepciones

InvalidOperationException

El administrador de serialización tiene una sesión de serialización activa.

Comentarios

Si la RecycleInstances propiedad es false, el CreateInstance método siempre creará una nueva instancia de un tipo. Si RecycleInstances es true, CreateInstance primero buscará en la tabla de nombres y el contenedor un objeto con el mismo nombre. Si este objeto existe y es del mismo tipo, CreateInstance devolverá la instancia existente. Esta segunda variación es útil para implementar un serializador que aplica el estado de serialización a un conjunto existente de objetos, en lugar de crear siempre un nuevo árbol. El comando Deshacer suele usar este tipo de serializador.

En el caso de que la RecycleInstances propiedad sea true, la ValidateRecycledTypes propiedad modificará aún más el comportamiento de en función de CreateInstance los tipos de los dos objetos.

Consulte también

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