DesignerSerializationManager.PreserveNames 属性

定义

命名空间:

System.ComponentModel.Design.Serialization

程序集:

System.Windows.Forms.Design.dll

获取或设置一个值，指示 CreateInstance(Type, ICollection, String, Boolean) 方法是否应该检查容器中是否存在给定名称。

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

属性值

Boolean

如果 CreateInstance(Type, ICollection, String, Boolean) 将传递给定组件名称，则为 true。如果 CreateInstance(Type, ICollection, String, Boolean) 将检查容器中是否存在给定名称，则为 false。 默认值为 true。

例外

InvalidOperationException

该属性已在序列化会话中发生更改。

注解

属性 PreserveNames 确定 方法的行为 CreateInstance 。 如果 true为 ， CreateInstance 则传递给定的组件名称。 如果false为 ，CreateInstance则检查容器中是否存在给定名称。 如果该名称在容器中不存在， CreateInstance 将使用给定的名称。 如果容器中确实存在该名称， CreateInstance 则在将组件添加到容器时，将传递一个 null 值作为组件的名称，从而为其提供新名称。 第二个变体可用于实现始终复制对象的序列化程序，而不是假定这些对象不存在。 粘贴命令通常使用此类型的序列化程序。

仅当不在序列化会话中时，才能更改此属性。

另请参阅

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