DesignerSerializationManager.PreserveNames Свойство

Определение

Пространство имен:

System.ComponentModel.Design.Serialization

Сборка:

System.Windows.Forms.Design.dll

Исходный код:

DesignerSerializationManager.cs

Возвращает или задает значение, указывающее, должен ли 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)