ControlDesigner.UsePreviewControl Свойство

Определение

Получает значение, указывающее, использует ли конструктор элементов управления временный элемент управления "Предварительный просмотр" для создания разметки HTML во время разработки.Gets a value indicating whether the control designer uses a temporary preview control to generate the design-time HTML markup.

protected:
 virtual property bool UsePreviewControl { bool get(); };
protected virtual bool UsePreviewControl { get; }
member this.UsePreviewControl : bool
Protected Overridable ReadOnly Property UsePreviewControl As Boolean

Значение свойства

Boolean

Значение true, если конструктор элементов управления использует временную копию элемента управления для предварительного просмотра во время разработки; значение false, если конструктор элементов управления использует свойство Component для элемента управления, содержащегося в конструкторе элементов управления.true, if the control designer uses a temporary copy of the control for design-time preview; otherwise, false, if the control designer uses the Component property for the control contained in the control designer.

Комментарии

Если UsePreviewControl свойство имеет значение true , ViewControl свойство возвращает временную копию элемента управления.If the UsePreviewControl property is true, the ViewControl property returns a temporary copy of the control. Изменения временного элемента управления не сохраняются в документе.Changes to the temporary control are not persisted to the document.

Если UsePreviewControl свойство имеет значение false , ViewControl свойство возвращает экземпляр Component свойства для элемента управления.If the UsePreviewControl property is false, the ViewControl property returns an instance of the Component property for the control. Изменения в экземпляре элемента управления сохраняются.Changes to the instance of the control are persisted.

SupportsPreviewControlПараметр в SupportsPreviewControlAttribute объекте используется для задания значения UsePreviewControl Свойства.The SupportsPreviewControl setting in the SupportsPreviewControlAttribute object is used to set the value of the UsePreviewControl property. Таким образом, SupportsPreviewControl параметр определяет тип элемента управления, возвращаемого ViewControl свойством в базовом ControlDesigner классе.Therefore, the SupportsPreviewControl setting determines the type of control that is returned by the ViewControl property in the base ControlDesigner class. Если параметр SupportsPreviewControlAttribute не указан в объявлении конструктора элементов управления, ControlDesigner поведение объекта эквивалентно указанию SupportsPreviewControl свойства как false .If the SupportsPreviewControlAttribute is not specified in the control designer declaration, the ControlDesigner object behavior is equivalent to specifying the SupportsPreviewControl property as false.

Примечания для тех, кто наследует этот метод

Пользовательские конструкторы, производные от ControlDesigner класса, могут переопределять UsePreviewControl свойство и игнорировать SupportsPreviewControlAttribute объект.Custom designers that are derived from the ControlDesigner class can override the UsePreviewControl property and ignore the SupportsPreviewControlAttribute object. Как правило, чтобы указать, что ViewControl свойство всегда возвращает временную копию элемента управления, переопределите UsePreviewControl свойство, чтобы оно всегда возвращало значение true .Generally, to indicate that the ViewControl property always returns a temporary copy of the control, override the UsePreviewControl property to always return true. Чтобы указать, что ViewControl свойство всегда возвращает экземпляр элемента управления, переопределите свойство, UsePreviewControl чтобы всегда возвращалось значение false .To indicate that the ViewControl property always returns an instance of the control, override the UsePreviewControl property to always return false. Например, PreviewControlDesigner класс является производным от класса ControlDesigner и всегда возвращает значение true для UsePreviewControl Свойства.For example, the PreviewControlDesigner class derives from the ControlDesigner and always returns true for the UsePreviewControl property.

Применяется к

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