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

Значение true, если метод CreateInstance(Type, ICollection, String, Boolean) передаст заданное имя компонента; значение false, если метод CreateInstance(Type, ICollection, String, Boolean) проверит наличие заданных имен в контейнере. Значение по умолчанию — true.

Исключения

InvalidOperationException

Это свойство было изменено вне сеанса сериализации.

Комментарии

Свойство PreserveNames определяет поведение CreateInstance метода . Если trueзадано значение , CreateInstance будет передано заданное имя компонента. Если falseзадано значение , CreateInstance будет проверять наличие заданного имени в контейнере. Если имя не существует в контейнере, CreateInstance будет использовать заданное имя. Если имя существует в контейнере, CreateInstance передает значение NULL в качестве имени компонента при его добавлении в контейнер, тем самым присвоив ему новое имя. Этот второй вариант полезен для реализации сериализатора, который всегда дублирует объекты, а не предполагает, что эти объекты не существуют. Команды вставки часто используют этот тип сериализатора.

Это свойство можно изменить только в том случае, если вы не находитесь в сеансе сериализации.

См. также раздел

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