DesignerSerializationManager.RecycleInstances Propriedade
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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
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
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.