WebFormsRootDesigner 类

定义

命名空间:

System.Web.UI.Design

程序集:

System.Design.dll

在设计时提供 Web 窗体页的设计时功能的一个基类并允许访问和操作包含在 Web 窗体页中的组件和控件。

public ref class WebFormsRootDesigner abstract : IDisposable, System::ComponentModel::Design::IDesignerFilter, System::ComponentModel::Design::IRootDesigner

public abstract class WebFormsRootDesigner : IDisposable, System.ComponentModel.Design.IDesignerFilter, System.ComponentModel.Design.IRootDesigner

type WebFormsRootDesigner = class
    interface IRootDesigner
    interface IDesigner
    interface IDisposable
    interface IDesignerFilter

Public MustInherit Class WebFormsRootDesigner
Implements IDesignerFilter, IDisposable, IRootDesigner

继承

Object

WebFormsRootDesigner

实现

IDesigner IDesignerFilter IRootDesigner IDisposable

注解

设计宿主（如 Visual Studio 2005）必须提供自己的 派生版本的 WebFormsRootDesigner 类，以便通过 RootDesigner 设计器的 属性控制设计器。 控件设计器在设计时使用 RootDesigner 属性访问和操作包含的 Web 窗体页。

实施者说明

从 WebFormsRootDesigner 类继承时，必须重写以下成员：

• DocumentUrl、IsDesignerViewLocked、、IsLoadingReferenceManager、 SupportedTechnologies和 Verbs 属性。

• AddClientScriptToDocument(ClientScriptItem)、AddControlToDocument(Control, Control, ControlLocation)、GetClientScriptsInDocument()、GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag)、 和 RemoveControlFromDocument(Control) 方法。

构造函数

WebFormsRootDesigner()

初始化 WebFormsRootDesigner 类的新实例。

属性

Component	获取或设置此设计器正在设计的组件。
CurrentCulture	获取当前线程的区域性信息。
DocumentUrl	在派生类中重写时，获取 Web 窗体页所在的 URL。
IsDesignerViewLocked	在派生类中重写时，获取一个指示设计器视图是否锁定的值。
IsLoading	在派生类中重写时，获取一个指示是否仍在加载 Web 窗体页的值。
ReferenceManager	在派生类中重写时，获取一个 WebFormsReferenceManager 对象，其中包含有关当前 Web 窗体页的信息。
SupportedTechnologies	获取设计器组件可为其显示提供支持的技术集。
Verbs	获取设计器支持的设计时谓词。

方法

AddClientScriptToDocument(ClientScriptItem)	在派生类中重写时，向当前 Web 窗体页中添加一个客户端脚本元素。
AddControlToDocument(Control, Control, ControlLocation)	在派生类中重写时，向 Web 窗体页中添加一个 Web 服务器控件。
CreateDesignerActionService(IServiceProvider)	返回一个设计时 DesignerActionService 对象。
CreateUrlResolutionService()	返回可解析相对 URL 的 IUrlResolutionService。
Dispose(Boolean)	释放由 WebFormsRootDesigner 占用的非托管资源并（可选）释放托管资源。
Equals(Object)	确定指定对象是否等于当前对象。 (继承自 Object)
Finalize()	在当前 WebFormsRootDesigner 对象的资源被垃圾回收器回收之前释放这些资源。
GenerateEmptyDesignTimeHtml(Control)	在设计时为控件生成空的 HTML 标记。
GenerateErrorDesignTimeHtml(Control, Exception, String)	生成 HTML 标记，用于在设计时通过使用指定的控件、异常和消息来显示错误消息。
GetClientScriptsInDocument()	在派生类中重写时，返回一个 ClientScriptItemCollection 对象，其中包含该页上的所有客户端脚本项。
GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag)	在派生类中重写时，返回指定控件的当前设计时视图和 HTML 标记。
GetHashCode()	作为默认哈希函数。 (继承自 Object)
GetService(Type)	返回所请求的服务。
GetType()	获取当前实例的 Type。 (继承自 Object)
GetView(ViewTechnology)	返回由提供的 ViewTechnology 对象所确定的视图对象。
Initialize(IComponent)	使用指定的组件初始化 WebFormsRootDesigner 对象。
MemberwiseClone()	创建当前 Object 的浅表副本。 (继承自 Object)
OnLoadComplete(EventArgs)	当 Web 窗体页完全加载后，引发 LoadComplete 事件。
PostFilterAttributes(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的特性集中更改或移除项。
PostFilterEvents(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的事件集中更改或移除项。
PostFilterProperties(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的属性集中更改或移除项。
PreFilterAttributes(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的特性集中添加项。
PreFilterEvents(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的事件集中添加项。
PreFilterProperties(IDictionary)	允许设计器在通过 TypeDescriptor 对象公开的属性集中添加项。
RemoveClientScriptFromDocument(String)	在设计时将指定客户端脚本从文档移除。
RemoveControlFromDocument(Control)	在派生类中重写时，从 Web 窗体页中移除指定的控件。
ResolveUrl(String)	将相对的 URL 转换为完全限定的 URL。
SetControlID(Control, String)	用指定的字符串设置指定控件的 ID 属性。
ToString()	返回表示当前对象的字符串。 (继承自 Object)

事件

LoadComplete

当设计器完成 Web 窗体页的加载时发生。

显式接口实现

IDesigner.DoDefaultAction()	有关此成员的说明，请参见 DoDefaultAction()。
IDesigner.Verbs	获取或设置设计器支持的设计时谓词。 有关此成员的说明，请参见 Verbs。
IDesignerFilter.PostFilterAttributes(IDictionary)	有关此成员的说明，请参见 PostFilterAttributes(IDictionary)。
IDesignerFilter.PostFilterEvents(IDictionary)	有关此成员的说明，请参见 PostFilterEvents(IDictionary)。
IDesignerFilter.PostFilterProperties(IDictionary)	有关此成员的说明，请参见 PostFilterProperties(IDictionary)。
IDesignerFilter.PreFilterAttributes(IDictionary)	有关此成员的说明，请参见 PreFilterAttributes(IDictionary)。
IDesignerFilter.PreFilterEvents(IDictionary)	有关此成员的说明，请参见 PreFilterEvents(IDictionary)。
IDesignerFilter.PreFilterProperties(IDictionary)	有关此成员的说明，请参见 PreFilterProperties(IDictionary)。
IDisposable.Dispose()	有关此成员的说明，请参见 Dispose()。
IRootDesigner.GetView(ViewTechnology)	获取指定视图技术的视图对象。 有关此成员的说明，请参见 GetView(ViewTechnology)。
IRootDesigner.SupportedTechnologies	获取设计器组件可为其显示提供支持的技术集。 有关此成员的说明，请参见 SupportedTechnologies。

另请参阅

• ASP.NET 控件设计器概述
• 扩展设计时支持
• 如何：在设计模式下扩展控件的外观和行为