DesignerSerializationManager.PreserveNames 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 o método CreateInstance(Type, ICollection, String, Boolean) deve verificar a presença do nome fornecido no contêiner.
public:
property bool PreserveNames { bool get(); void set(bool value); };
public bool PreserveNames { get; set; }
member this.PreserveNames : bool with get, set
Public Property PreserveNames As Boolean
Valor da propriedade
true
se CreateInstance(Type, ICollection, String, Boolean) passar o nome do componente fornecido; false
se CreateInstance(Type, ICollection, String, Boolean) for marcar para a presença do nome fornecido no contêiner. O padrão é true
.
Exceções
Essa propriedade foi alterada de dentro de uma sessão de serialização.
Comentários
A PreserveNames propriedade determina o comportamento do CreateInstance método . Se true
, CreateInstance passará o nome do componente fornecido. Se false
, CreateInstance marcar para a presença do nome fornecido no contêiner. Se o nome não existir no contêiner, CreateInstance usará o nome fornecido. Se o nome existir no contêiner, CreateInstance passará um valor nulo como o nome de um componente ao adicioná-lo ao contêiner, dando a ele um novo nome. Essa segunda variação é útil para implementar um serializador que sempre duplica objetos, em vez de assumir que esses objetos não existem. Comandos de colagem geralmente usam esse tipo de serializador.
Você só pode alterar essa propriedade quando não estiver em uma sessão de serialização.