DesignerSerializationManager.RecycleInstances Propriedade

Definição

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

Obtém ou define um valor que indica se CreateInstance(Type, ICollection, String, Boolean) sempre criará uma instância de um 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 da propriedade

Boolean

true se CreateInstance(Type, ICollection, String, Boolean) retornará a instância existente; false se CreateInstance(Type, ICollection, String, Boolean) criará uma nova instância de um tipo. O padrão é false.

Exceções

InvalidOperationException

O gerenciador de serialização tem uma sessão de serialização ativa.

Comentários

Se a RecycleInstances propriedade for false, o CreateInstance método sempre criará uma nova instância de um tipo. Se RecycleInstances for true, CreateInstance primeiro pesquisará a tabela de nomes e o contêiner em busca de um objeto de mesmo nome. Se esse objeto existir e for do mesmo tipo, CreateInstance retornará a instância existente. Essa segunda variação é útil para implementar um serializador que aplica o estado de serialização a um conjunto existente de objetos, em vez de sempre criar uma nova árvore. O comando Desfazer geralmente usa esse tipo de serializador.

No caso em que a RecycleInstances propriedade é true, a ValidateRecycledTypes propriedade modificará ainda mais o comportamento de CreateInstance dependendo dos tipos dos dois objetos.

Confira também

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