DesignerSerializationManager.PreserveNames Propriedade

Definição

Namespace:

System.ComponentModel.Design.Serialization

Assembly:

System.Windows.Forms.Design.dll

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

Boolean

truese 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

InvalidOperationException

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.

Confira também

• DesignerSerializationManager
• CreateInstance(Type, ICollection, String, Boolean)