DesignerSerializationManager.PreserveNames Propiedad

Definición

Espacio de nombres:

System.ComponentModel.Design.Serialization

Ensamblado:

System.Windows.Forms.Design.dll

Obtiene o establece un valor que indica si el método CreateInstance(Type, ICollection, String, Boolean) debe comprobar la presencia del nombre especificado en el contenedor.

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 de propiedad

Boolean

true si CreateInstance(Type, ICollection, String, Boolean) va a pasar el nombre de componente determinado; false si CreateInstance(Type, ICollection, String, Boolean) va a comprobar la presencia del nombre determinado en el contenedor. De manera predeterminada, es true.

Excepciones

InvalidOperationException

El cambio de esta propiedad se realizó desde una sesión de serialización.

Comentarios

La PreserveNames propiedad determina el comportamiento del CreateInstance método . Si truees , CreateInstance pasará el nombre del componente especificado. Si falsees , CreateInstance comprobará la presencia del nombre especificado en el contenedor. Si el nombre no existe en el contenedor, CreateInstance usará el nombre especificado. Si el nombre existe en el contenedor, CreateInstance pasará un valor NULL como nombre de un componente al agregarlo al contenedor, lo que le dará un nuevo nombre. Esta segunda variación es útil para implementar un serializador que siempre duplica objetos, en lugar de asumir que esos objetos no existen. Los comandos paste suelen usar este tipo de serializador.

Solo puede cambiar esta propiedad cuando no esté en una sesión de serialización.

Consulte también

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