WebPartManagerDesigner 类
定义
提供对 WebPartManager 控件的最低设计时支持。Provides minimal design-time support for WebPartManager controls.
public ref class WebPartManagerDesigner : System::Web::UI::Design::ControlDesigner
public class WebPartManagerDesigner : System.Web.UI.Design.ControlDesigner
type WebPartManagerDesigner = class
inherit ControlDesigner
Public Class WebPartManagerDesigner
Inherits ControlDesigner
- 继承
示例
下面的代码示例演示如何 WebPartManager 通过重写设计器的方法来更改自定义控件的设计时外观 GetDesignTimeHtml 。The following code example shows how to change the design-time appearance of a custom WebPartManager control by overriding the GetDesignTimeHtml method of the designer.
using System;
using System.Web;
using System.Security.Permissions;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.Design.WebControls.WebParts;
using System.ComponentModel;
/// <summary>
/// The PrettyPartManager class is an inherited copy of WebPartManager for
/// the purpose of applying the PrettyPartManagerDesigner at design time.
/// PrettyPartManager provides an arbitrary design time rendering of the
/// control by overriding GetDesignTimeHtml()
/// </summary>
namespace Samples.AspNet.CS.Controls
{
[AspNetHostingPermission(SecurityAction.Demand,
Level = AspNetHostingPermissionLevel.Minimal)]
[AspNetHostingPermission(SecurityAction.InheritanceDemand,
Level = AspNetHostingPermissionLevel.Minimal)]
[Designer(typeof(PrettyPartManagerDesigner))]
public class PrettyPartManager : WebPartManager {}
public class PrettyPartManagerDesigner : WebPartManagerDesigner
{
public override string GetDesignTimeHtml()
{
string designTimeHtml = "";
designTimeHtml = "<div style=\"background-color:bisque;";
designTimeHtml += "border:thick groove mediumseagreen\">";
designTimeHtml += "<span style=\"font:italic 16pt bold Garamond\">";
designTimeHtml += "PrettyPartManager</span><br />";
designTimeHtml += "<span style=\"font:italic 12pt Garamond\">";
WebPartManager m = (WebPartManager)Component;
designTimeHtml += m.ID;
designTimeHtml += "</ span></ div>";
return designTimeHtml;
}
}
}
Imports System.Web
Imports System.Security.Permissions
Imports System.Web.UI.WebControls.WebParts
Imports System.Web.UI.Design.WebControls.WebParts
Imports System.ComponentModel
' The PrettyPartManager class is an inherited copy of WebPartManager for
' the purpose of applying the PrettyPartManagerDesigner at design time.
' PrettyPartManager provides an arbitrary design time rendering of the
' control by overriding GetDesignTimeHtml()
Namespace Samples.AspNet.VB.Controls
<AspNetHostingPermission(SecurityAction.Demand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<AspNetHostingPermission(SecurityAction.InheritanceDemand, Level:=AspNetHostingPermissionLevel.Minimal)> _
<Designer(GetType(PrettyPartManagerDesigner))> _
Public Class PrettyPartManager
Inherits WebPartManager
End Class
Public Class PrettyPartManagerDesigner
Inherits WebPartManagerDesigner
Public Overrides Function GetDesignTimeHtml() As String
Dim designTimeHtml As String = ""
designTimeHtml = "<div style=""background-color:bisque;"
designTimeHtml += "border:thick groove mediumseagreen"">"
designTimeHtml += "<span style=""font:italic 16pt bold Garamond"">"
designTimeHtml += "PrettyPartManager</span><br />"
designTimeHtml += "<span style=""font:italic 12pt Garamond"">"
Dim m As WebPartManager = DirectCast(Component, WebPartManager)
designTimeHtml += m.ID
designTimeHtml += "</ span></ div>"
Return designTimeHtml
End Function
End Class
End Namespace
注解
WebPartManagerDesigner类提供控件的最小设计时呈现 WebPartManager 。The WebPartManagerDesigner class provides a bare-minimum design-time rendering of the WebPartManager control. 它在设计图面上显示为显示类名称和当前 ID 的纯灰框 WebPartManager 。It appears on the design surface as a plain gray box showing the name of the class and the ID of the current WebPartManager. 可以 WebPartManager 通过以 GetDesignTimeHtml 与任何标准相同的方式重写方法来更改自定义控件的呈现方式 ControlDesigner 。You can change the rendering of a custom WebPartManager control by overriding the GetDesignTimeHtml method in the same manner as with any standard ControlDesigner. 此 UsePreviewControl 属性被重写以始终返回 true 。The UsePreviewControl property is overridden to always return true.
构造函数
| WebPartManagerDesigner() |
初始化 WebPartManagerDesigner 类的新实例。Initializes a new instance of the WebPartManagerDesigner class. |
属性
| ActionLists |
获取控件设计器的操作列表集合。Gets the action list collection for the control designer. (继承自 ControlDesigner) |
| AllowResize |
获取一个值,该值指示是否可以在设计时环境中调整控件的大小。Gets a value indicating whether the control can be resized in the design-time environment. (继承自 ControlDesigner) |
| AssociatedComponents |
获取与设计器所管理的组件关联的组件集合。Gets the collection of components associated with the component managed by the designer. (继承自 ComponentDesigner) |
| AutoFormats |
获取预定义自动格式设置方案的集合,这些方案将在设计时显示于关联控件的“自动套用格式”对话框中。Gets the collection of predefined automatic formatting schemes to display in the Auto Format dialog box for the associated control at design time. (继承自 ControlDesigner) |
| Behavior |
已过时。
获取或设置与设计器关联的 DHTML 行为。Gets or sets the DHTML behavior that is associated with the designer. (继承自 HtmlControlDesigner) |
| Component |
获取此设计器正在设计的组件。Gets the component this designer is designing. (继承自 ComponentDesigner) |
| DataBindings |
获取当前控件的数据绑定集合。Gets the data bindings collection for the current control. (继承自 HtmlControlDesigner) |
| DataBindingsEnabled |
获取一个值,该值指示包含关联控件的区域是否支持数据绑定。Gets a value indicating whether data binding is supported by the containing region for the associated control. (继承自 ControlDesigner) |
| DesignerState |
获取用于在设计时保持关联控件数据的对象。Gets an object that is used to persist data for the associated control at design time. (继承自 ControlDesigner) |
| DesignTimeElement |
已过时。
获取一个设计时对象,该对象表示与设计图面上的 HtmlControlDesigner 对象关联的控件。Gets the design-time object representing the control that is associated with the HtmlControlDesigner object on the design surface. (继承自 HtmlControlDesigner) |
| DesignTimeElementView |
已过时。
获取控件设计器的视图控件对象。Gets the view-control object for the control designer. (继承自 ControlDesigner) |
| DesignTimeHtmlRequiresLoadComplete |
已过时。
获取一个值,该值指示是否必须在设计宿主完成加载之后才能调用 GetDesignTimeHtml 方法。Gets a value indicating whether the design host must finish loading before the GetDesignTimeHtml method can be called. (继承自 ControlDesigner) |
| Expressions |
获取当前控件在设计时的表达式绑定。Gets the expression bindings for the current control at design time. (继承自 HtmlControlDesigner) |
| HidePropertiesInTemplateMode |
获取一个值,该值指示当控件处于模板模式时,关联控件的属性是否被隐藏。Gets a value indicating whether the properties of the associated control are hidden when the control is in template mode. (继承自 ControlDesigner) |
| ID |
获取或设置控件的 ID 字符串。Gets or sets the ID string for the control. (继承自 ControlDesigner) |
| InheritanceAttribute |
获取一个特性,该特性指示关联组件的继承类型。Gets an attribute that indicates the type of inheritance of the associated component. (继承自 ComponentDesigner) |
| Inherited |
获取一个值,该值指示是否继承此组件。Gets a value indicating whether this component is inherited. (继承自 ComponentDesigner) |
| InTemplateMode |
获取一个值,该值指示控件在设计宿主中是否处于模板查看模式或模板编辑模式之一。Gets a value indicating whether the control is in either template viewing or editing mode in the design host. InTemplateMode 属性为只读。The InTemplateMode property is read-only. (继承自 ControlDesigner) |
| IsDirty |
已过时。
获取或设置一个值,该值指示 Web 服务器控件是否已被标记为已更改。Gets or sets a value indicating whether the Web server control has been marked as changed. (继承自 ControlDesigner) |
| ParentComponent |
获取此设计器的父组件。Gets the parent component for this designer. (继承自 ComponentDesigner) |
| ReadOnly |
已过时。
获取或设置一个值,该值指示控件的属性在设计时是否为只读。Gets or sets a value indicating whether the properties of the control are read-only at design time. (继承自 ControlDesigner) |
| RootDesigner |
获取包含关联控件的 Web 窗体页的控件设计器。Gets the control designer for the Web Forms page that contains the associated control. (继承自 ControlDesigner) |
| ShadowProperties |
获取重写用户设置的属性值的集合。Gets a collection of property values that override user settings. (继承自 ComponentDesigner) |
| ShouldCodeSerialize |
已过时。
获取或设置一个值,该值指示在序列化期间是否应为当前设计文档在代码隐藏文件中创建控件的字段声明。Gets or sets a value indicating whether to create a field declaration for the control in the code-behind file for the current design document during serialization. (继承自 HtmlControlDesigner) |
| Tag |
获取表示关联控件的 HTML 标记元素的对象。Gets an object representing the HTML markup element for the associated control. (继承自 ControlDesigner) |
| TemplateGroups |
获取一个模板组集合,其中每个模板组包含一个或多个模板定义。Gets a collection of template groups, each containing one or more template definitions. (继承自 ControlDesigner) |
| UsePreviewControl |
获取一个值,该值指示设计器是否应使用临时副本取代与设计器关联的实际控件来生成设计时标记。Gets a value indicating whether the designer should use a temporary copy rather than the actual control associated with the designer to generate the design-time markup. |
| Verbs |
获取与设计器相关联的组件所支持的设计时谓词。Gets the design-time verbs supported by the component that is associated with the designer. (继承自 ComponentDesigner) |
| ViewControl |
获取或设置可用于预览设计时 HTML 标记的 Web 服务器控件。Gets or sets a Web server control that can be used for previewing the design-time HTML markup. (继承自 ControlDesigner) |
| ViewControlCreated |
获取或设置一个值,该值指示是否已创建 |
| Visible |
获取指示该控件在设计时是否可见的值。Gets a value that indicates whether the control is visible at design time. (继承自 ControlDesigner) |
方法
| CreateErrorDesignTimeHtml(String) |
创建在设计时显示指定错误消息的 HTML 标记。Creates HTML markup to display a specified error message at design time. (继承自 ControlDesigner) |
| CreateErrorDesignTimeHtml(String, Exception) |
创建在设计时显示指定异常错误消息的 HTML 标记。Creates the HTML markup to display a specified exception error message at design time. (继承自 ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml() |
提供一个简单的矩形占位符表示形式,该表示形式显示该控件的类型和 ID。Provides a simple rectangular placeholder representation that displays the type and ID of the control. (继承自 ControlDesigner) |
| CreatePlaceHolderDesignTimeHtml(String) |
提供一个简单的矩形占位符表示形式,该表示形式显示该控件的类型和 ID 以及指定的附加说明或信息。Provides a simple rectangular placeholder representation that displays the type and ID of the control, and also additional specified instructions or information. (继承自 ControlDesigner) |
| CreateViewControl() |
返回要在设计图面上查看或呈现的关联控件的副本。Returns a copy of the associated control for viewing or rendering on the design surface. (继承自 ControlDesigner) |
| Dispose() |
释放由 ComponentDesigner 使用的所有资源。Releases all resources used by the ComponentDesigner. (继承自 ComponentDesigner) |
| Dispose(Boolean) |
释放由 HtmlControlDesigner 对象占用的非托管资源,还可以选择释放托管资源。Releases the unmanaged resources that are used by the HtmlControlDesigner object and optionally releases the managed resources. (继承自 HtmlControlDesigner) |
| DoDefaultAction() |
在源代码文件中为组件的默认事件创建方法签名,并将用户的光标定位到该位置。Creates a method signature in the source code file for the default event on the component and navigates the user's cursor to that location. (继承自 ComponentDesigner) |
| Equals(Object) |
确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object. (继承自 Object) |
| GetBounds() |
检索矩形的坐标,该矩形表示设计图面上显示的控件的边界。Retrieves the coordinates of the rectangle representing the boundaries for the control as displayed on the design surface. (继承自 ControlDesigner) |
| GetDesignTimeHtml() |
返回一个空字符串 (""),该值指示可视化设计环境应恢复为默认控件呈现。Returns an empty string (""), which indicates that the visual design environment should revert to default control rendering. |
| GetDesignTimeHtml(DesignerRegionCollection) |
检索用当前控件设计器区域显示控件并填充集合的 HTML 标记。Retrieves the HTML markup to display the control and populates the collection with the current control designer regions. (继承自 ControlDesigner) |
| GetEditableDesignerRegionContent(EditableDesignerRegion) |
返回关联控件设计时视图中可编辑区域的内容。Returns the content for an editable region of the design-time view of the associated control. (继承自 ControlDesigner) |
| GetEmptyDesignTimeHtml() |
检索表示在设计时将不具有可视表示形式的运行时 Web 服务器控件的 HTML 标记。Retrieves the HTML markup to represent a Web server control at design time that will have no visual representation at run time. (继承自 ControlDesigner) |
| GetErrorDesignTimeHtml(Exception) |
检索 HTML 标记,该标记提供有关指定异常的信息。Retrieves the HTML markup that provides information about the specified exception. (继承自 ControlDesigner) |
| GetHashCode() |
作为默认哈希函数。Serves as the default hash function. (继承自 Object) |
| GetPersistenceContent() |
在设计时检索该控件的持久内部 HTML 标记。Retrieves the persistable inner HTML markup of the control at design time. (继承自 ControlDesigner) |
| GetPersistInnerHtml() |
已过时。
检索控件的持久性内部 HTML 标记。Retrieves the persistable inner HTML markup of the control. (继承自 ControlDesigner) |
| GetService(Type) |
尝试从设计器组件的设计模式站点检索指定类型的服务。Attempts to retrieve the specified type of service from the design mode site of the designer's component. (继承自 ComponentDesigner) |
| GetType() |
获取当前实例的 Type。Gets the Type of the current instance. (继承自 Object) |
| GetViewRendering() |
检索一个对象,该对象包含关联控件的内容和区域的设计时标记。Retrieves an object that contains the design-time markup for the content and regions of the associated control. (继承自 ControlDesigner) |
| Initialize(IComponent) |
将设计器绑定到关联的 WebPartManager 控件。Binds the designer to the associated WebPartManager control. |
| InitializeExistingComponent(IDictionary) |
重新初始化现有组件。Reinitializes an existing component. (继承自 ComponentDesigner) |
| InitializeNewComponent(IDictionary) |
初始化新创建的组件。Initializes a newly created component. (继承自 ComponentDesigner) |
| InitializeNonDefault() |
已过时。
对已初始化为非默认设置的导入组件的设置进行初始化。Initializes the settings for an imported component that is already initialized to settings other than the defaults. (继承自 ComponentDesigner) |
| Invalidate() |
使显示在设计图面上的控件的整个区域无效,并向控件设计器发送重新绘制控件的信号。Invalidates the whole area of the control that is displayed on the design surface and signals the control designer to redraw the control. (继承自 ControlDesigner) |
| Invalidate(Rectangle) |
使显示在设计图面上的控件的指定区域无效,并向控件设计器发送重新绘制控件的信号。Invalidates the specified area of the control that is displayed on the design surface and signals the control designer to redraw the control. (继承自 ControlDesigner) |
| InvokeGetInheritanceAttribute(ComponentDesigner) |
获取指定 InheritanceAttribute 的 ComponentDesigner。Gets the InheritanceAttribute of the specified ComponentDesigner. (继承自 ComponentDesigner) |
| IsPropertyBound(String) |
已过时。
检索一个值,该值指示关联控件上的指定属性是否是数据绑定的。Retrieves a value indicating whether the specified property on the associated control is data-bound. (继承自 ControlDesigner) |
| Localize(IDesignTimeResourceWriter) |
使用提供的资源编写器将关联控件的可本地化属性保持到设计宿主中的某个资源。Uses the provided resource writer to persist the localizable properties of the associated control to a resource in the design host. (继承自 ControlDesigner) |
| MemberwiseClone() |
创建当前 Object 的浅表副本。Creates a shallow copy of the current Object. (继承自 Object) |
| OnAutoFormatApplied(DesignerAutoFormat) |
对关联控件应用预定义的自动格式设置方案后调用。Called when a predefined, automatic formatting scheme has been applied to the associated control. (继承自 ControlDesigner) |
| OnBehaviorAttached() |
将控件设计器附加到 Behavior 对象时调用。Called when the control designer is attached to a Behavior object. (继承自 ControlDesigner) |
| OnBehaviorDetaching() |
已过时。
当某个行为与该元素取消关联时被调用。Called when a behavior disassociates from the element. (继承自 HtmlControlDesigner) |
| OnBindingsCollectionChanged(String) |
已过时。
在数据绑定集合发生更改时调用。Called when the data-binding collection changes. (继承自 ControlDesigner) |
| OnClick(DesignerRegionMouseEventArgs) |
当用户在设计时单击关联控件时由设计宿主调用。Called by the design host when the user clicks the associated control at design time. (继承自 ControlDesigner) |
| OnComponentChanged(Object, ComponentChangedEventArgs) |
在关联控件发生更改时调用。Called when the associated control changes. (继承自 ControlDesigner) |
| OnComponentChanging(Object, ComponentChangingEventArgs) |
表示将处理关联控件的 ComponentChanging 事件的方法。Represents the method that will handle the ComponentChanging event for the associated control. (继承自 ControlDesigner) |
| OnControlResize() |
已过时。
关联的 Web 服务器控件的大小在设计宿主中发生设计时调整后被调用。Called when the associated Web server control has been resized in the design host at design time. (继承自 ControlDesigner) |
| OnPaint(PaintEventArgs) |
当控件设计器在设计图面上绘制关联控件,且 CustomPaint 的值为 |
| OnSetComponentDefaults() |
已过时。
设置组件的默认属性。Sets the default properties for the component. (继承自 ComponentDesigner) |
| OnSetParent() |
提供一种在将关联控件附加到父控件时执行附加处理的方式。Provides a way to perform additional processing when the associated control is attached to a parent control. (继承自 HtmlControlDesigner) |
| PostFilterAttributes(IDictionary) |
允许设计器从通过 TypeDescriptor 公开的特性集中更改或移除项。Allows a designer to change or remove items from the set of attributes that it exposes through a TypeDescriptor. (继承自 ComponentDesigner) |
| PostFilterEvents(IDictionary) |
允许设计器从通过 TypeDescriptor 公开的事件集中更改或移除项。Allows a designer to change or remove items from the set of events that it exposes through a TypeDescriptor. (继承自 ComponentDesigner) |
| PostFilterProperties(IDictionary) |
允许设计器从通过 TypeDescriptor 公开的属性集中更改或移除项。Allows a designer to change or remove items from the set of properties that it exposes through a TypeDescriptor. (继承自 ComponentDesigner) |
| PreFilterAttributes(IDictionary) |
允许设计器在通过 TypeDescriptor 公开的特性集中添加项。Allows a designer to add to the set of attributes that it exposes through a TypeDescriptor. (继承自 ComponentDesigner) |
| PreFilterEvents(IDictionary) |
设置在设计时为用于组件的 TypeDescriptor 对象公开的事件列表。Sets the list of events that are exposed at design-time for the TypeDescriptor object for the component. (继承自 HtmlControlDesigner) |
| PreFilterProperties(IDictionary) |
在设计时向设计宿主中的“属性”网格添加属性或从中移除属性,或提供可能与关联控件上的属性相对应的新设计时属性。Adds properties to or removes properties from the Properties grid in a design host at design time or provides new design-time properties that might correspond to properties on the associated control. (继承自 ControlDesigner) |
| RaiseComponentChanged(MemberDescriptor, Object, Object) |
通知 IComponentChangeService 此组件已被更改。Notifies the IComponentChangeService that this component has been changed. (继承自 ComponentDesigner) |
| RaiseComponentChanging(MemberDescriptor) |
通知 IComponentChangeService 此组件即将被更改。Notifies the IComponentChangeService that this component is about to be changed. (继承自 ComponentDesigner) |
| RaiseResizeEvent() |
已过时。
引发 OnControlResize() 事件。Raises the OnControlResize() event. (继承自 ControlDesigner) |
| RegisterClone(Object, Object) |
注册克隆控件中的内部数据。Registers internal data in a cloned control. (继承自 ControlDesigner) |
| SetEditableDesignerRegionContent(EditableDesignerRegion, String) |
指定设计时控件可编辑区域的内容。Specifies the content for an editable region of the control at design time. (继承自 ControlDesigner) |
| SetRegionContent(EditableDesignerRegion, String) |
指定控件设计时视图中可编辑区域的内容。Specifies the content for an editable region in the design-time view of the control. (继承自 ControlDesigner) |
| SetViewFlags(ViewFlags, Boolean) |
将指定的按位 ViewFlags 枚举分配给指定的标志值。Assigns the specified bitwise ViewFlags enumeration to the specified flag value. (继承自 ControlDesigner) |
| ToString() |
返回表示当前对象的字符串。Returns a string that represents the current object. (继承自 Object) |
| UpdateDesignTimeHtml() |
通过调用 GetDesignTimeHtml 方法刷新关联 Web 服务器控件的设计时 HTML 标记。Refreshes the design-time HTML markup for the associated Web server control by calling the GetDesignTimeHtml method. (继承自 ControlDesigner) |