DesignerSerializationManager.PreserveNames 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.
Recebe ou define um valor que indica se o CreateInstance(Type, ICollection, String, Boolean) método deve verificar a presença do nome dado no contentor.
public:
property bool PreserveNames { bool get(); void set(bool value); };public bool PreserveNames { get; set; }member this.PreserveNames : bool with get, setPublic Property PreserveNames As BooleanValor de Propriedade
true If CreateInstance(Type, ICollection, String, Boolean) irá passar o nome dado do componente; false if CreateInstance(Type, ICollection, String, Boolean) irá verificar a presença do nome próprio no contentor. A predefinição é true.
Exceções
Esta propriedade foi alterada dentro de uma sessão de serialização.
Observações
A PreserveNames propriedade determina o comportamento do CreateInstance método. Se true, CreateInstance passará o nome dado do componente. Se false, CreateInstance verificará a presença do nome próprio no recipiente. Se o nome não existir no contentor, CreateInstance usará o nome próprio. Se o nome existir no contentor, CreateInstance passará um valor nulo como nome de um componente ao adicioná-lo ao contentor, dando-lhe assim um novo nome. Esta segunda variação é útil para implementar um serializador que duplica sempre os objetos, em vez de assumir que esses objetos não existem. Os comandos de colar usam frequentemente este tipo de serializador.
Só pode alterar esta propriedade quando não estiver numa sessão de serialização.