System.Web.UI.Design.ControlDesigner.UsePreviewControl Property

Gets a value indicating whether the control designer uses a temporary preview control to generate the design-time HTML markup.


protected virtual bool UsePreviewControl { get; }


Documentation for this section has not yet been entered.


If the ControlDesigner.UsePreviewControl property is true, the ControlDesigner.ViewControl property returns a temporary copy of the control. Changes to the temporary control are not persisted to the document.

If the ControlDesigner.UsePreviewControl property is false, the ControlDesigner.ViewControl property returns an instance of the System.ComponentModel.Design.ComponentDesigner.Component property for the control. Changes to the instance of the control are persisted.

The SupportsPreviewControlAttribute.SupportsPreviewControl setting in the System.Web.UI.Design.SupportsPreviewControlAttribute object is used to set the value of the ControlDesigner.UsePreviewControl property. Therefore, the SupportsPreviewControlAttribute.SupportsPreviewControl setting determines the type of control that is returned by the ControlDesigner.ViewControl property in the base System.Web.UI.Design.ControlDesigner class. If the System.Web.UI.Design.SupportsPreviewControlAttribute is not specified in the control designer declaration, the System.Web.UI.Design.ControlDesigner object behavior is equivalent to specifying the SupportsPreviewControlAttribute.SupportsPreviewControl property as false.


Namespace: System.Web.UI.Design
Assembly: System.Design (in System.Design.dll)
Assembly Versions: