DesignerSerializationManager.PreserveNames Свойство
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Возвращает или задает значение, указывающее на то, выполнять ли методу 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
Значение свойства
Значение true
, если метод CreateInstance(Type, ICollection, String, Boolean) передаст заданное имя компонента; значение false
, если метод CreateInstance(Type, ICollection, String, Boolean) проверит наличие заданных имен в контейнере. Значение по умолчанию — true
.
Исключения
Это свойство было изменено вне сеанса сериализации.
Комментарии
Свойство PreserveNames определяет поведение CreateInstance метода . Если true
задано значение , CreateInstance будет передано заданное имя компонента. Если false
значение , CreateInstance проверка наличие заданного имени в контейнере. Если имя не существует в контейнере, CreateInstance будет использовать заданное имя. Если имя существует в контейнере, CreateInstance передает значение NULL в качестве имени компонента при его добавлении в контейнер, тем самым присвоив ему новое имя. Этот второй вариант полезен для реализации сериализатора, который всегда дублирует объекты, а не предполагает, что эти объекты не существуют. Команды вставки часто используют этот тип сериализатора.
Это свойство можно изменить только в том случае, если вы не находитесь в сеансе сериализации.