WebFormsRootDesigner 類別

定義

命名空間:

System.Web.UI.Design

組件:

System.Design.dll

提供 Web Forms 網頁設計階段功能的基底類別，並允許在執行階段存取與操作 Web Forms 網頁內所包含的元件和控制項。

C#

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

繼承

Object

WebFormsRootDesigner

實作

IDesigner IDesignerFilter IRootDesigner IDisposable

備註

Visual Studio 2005 等設計主機必須提供自己的衍生類別版本 WebFormsRootDesigner ，才能透過 RootDesigner 設計工具的 屬性來控制設計工具。 控件設計工具會 RootDesigner 使用 屬性，在設計時間存取及操作包含的 Web Forms 頁面。

給實施者的注意事項

當您繼承自 類別時 WebFormsRootDesigner ，必須覆寫下列成員：

• DocumentUrl、IsDesignerViewLocked、IsLoading、ReferenceManager、 SupportedTechnologies和 Verbs 屬性。

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

建構函式

WebFormsRootDesigner()

初始化 WebFormsRootDesigner 類別的新執行個體。

屬性

Component	取得或設定這個設計工具正在設計的元件。
CurrentCulture	取得目前執行緒的文化特性 (Culture) 資訊。
DocumentUrl	在衍生類別中覆寫時，取得 Web Form 網頁所在的 URL。
IsDesignerViewLocked	在衍生類別中覆寫時，取得值，指出是否鎖定了設計工具檢視。
IsLoading	在衍生類別中覆寫時，取得值，指出是否仍在載入 Web Form 網頁。
ReferenceManager	在衍生類別中覆寫時，取得具有目前 Web Form 網頁之相關資訊的 WebFormsReferenceManager 物件。
SupportedTechnologies	取得技術的陣列，該設計工具元件可支援其顯示。
Verbs	取得設計工具所支援的設計階段動詞命令。

方法

AddClientScriptToDocument(ClientScriptItem)	在衍生類別中覆寫時，將用戶端指令碼項目加入目前的 Web Form 網頁。
AddControlToDocument(Control, Control, ControlLocation)	在衍生類別中覆寫時，將 Web 伺服器控制項加入 Web Form 網頁。
CreateDesignerActionService(IServiceProvider)	傳回設計階段 DesignerActionService 物件。
CreateUrlResolutionService()	傳回解析相對 URL 的 IUrlResolutionService。
Dispose(Boolean)	釋放 WebFormsRootDesigner 所使用的 Unmanaged 資源，並選擇性釋放 Managed 資源。
Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
Finalize()	在記憶體回收行程回收目前 WebFormsRootDesigner 物件的資源前，先將它的資源釋放。
GenerateEmptyDesignTimeHtml(Control)	在設計階段產生控制項的空白 HTML 標記。
GenerateErrorDesignTimeHtml(Control, Exception, String)	產生 HTML 標記，其可透過使用指定的控制項、例外狀況 (Exception) 和訊息在設計階段顯示錯誤訊息。
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 Form 網頁完全載入時，引發 LoadComplete 事件。
PostFilterAttributes(IDictionary)	允許設計工具變更或移除其透過 TypeDescriptor 物件所公開 (Expose) 之屬性集中的項目。
PostFilterEvents(IDictionary)	允許設計工具變更或移除其透過 TypeDescriptor 物件所公開之事件集中的項目。
PostFilterProperties(IDictionary)	允許設計工具變更或移除其透過 TypeDescriptor 物件所公開之屬性集中的項目。
PreFilterAttributes(IDictionary)	允許設計工具加入至其透過 TypeDescriptor 物件所公開的屬性集。
PreFilterEvents(IDictionary)	允許設計工具將項目加入至其透過 TypeDescriptor 物件所公開的事件集。
PreFilterProperties(IDictionary)	允許設計工具將項目加入至其透過 TypeDescriptor 物件所公開的屬性集。
RemoveClientScriptFromDocument(String)	在設計階段移除文件中的指定用戶端指令碼。
RemoveControlFromDocument(Control)	在衍生類別中覆寫時，從 Web Form 網頁移除指定的控制項。
ResolveUrl(String)	將相對 URL 轉換為完整的 URL。
SetControlID(Control, String)	使用指定的字串，設定指定之控制項的 ID 屬性。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

事件

LoadComplete

發生於設計工具完成 Web Form 網頁的載入時。

明確介面實作

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 控件設計工具概觀
• 擴充設計階段支援
• 如何：在設計模式中擴充控制項的外觀和行為