Partilhar via


DesignerSerializationManager.RecycleInstances Propriedade

Definição

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.

Aplica-se a

Confira também