DesignerSerializationManager.RecycleInstances Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém ou define um valor que indica se CreateInstance(Type, ICollection, String, Boolean) irá sempre criar uma nova 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, setPublic Property RecycleInstances As BooleanValor de Propriedade
true se CreateInstance(Type, ICollection, String, Boolean) devolverá a instância existente; false se CreateInstance(Type, ICollection, String, Boolean) criará uma nova instância de um tipo. A predefinição é false.
Exceções
O gestor de serialização tem uma sessão ativa de serialização.
Observações
Se a RecycleInstances propriedade for false, o CreateInstance método criará sempre uma nova instância de um tipo. Se RecycleInstances for true, CreateInstance irá primeiro pesquisar na tabela de nomes e no contentor um objeto com o mesmo nome. Se tal objeto existir e for do mesmo tipo, CreateInstance devolverá a instância existente. Esta segunda variação é útil para implementar um serializador que aplica o estado de serialização a um conjunto existente de objetos, em vez de criar sempre uma nova árvore. O comando Undo utiliza frequentemente este tipo de serializador.
No caso em que a RecycleInstances propriedade é true, a ValidateRecycledTypes propriedade irá modificar ainda mais o comportamento de CreateInstance dependendo dos tipos dos dois objetos.