WebFormsRootDesigner WebFormsRootDesigner WebFormsRootDesigner WebFormsRootDesigner Class

定義

為 Web Form 網頁的設計階段功能提供基底類別,並允許在設計階段存取和管理 Web Form 網頁中所包含的元件和控制項。Provides a base class for the design-time functionality of a Web Forms page and allows access to and manipulation of components and controls that are contained within the Web Forms page at design time.

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
繼承
WebFormsRootDesignerWebFormsRootDesignerWebFormsRootDesignerWebFormsRootDesigner
實作

備註

設計主應用程式,例如Visual Studio 2005Visual Studio 2005,必須提供自己的衍生的版本WebFormsRootDesigner類別的控制項設計工具,透過RootDesigner設計工具的屬性。A design host, such as Visual Studio 2005Visual Studio 2005, must provide its own derived version of the WebFormsRootDesigner class to control designers through the RootDesigner property of the designer. 控制對設計工具使用RootDesigner來存取及管理內含的 Web Form 網頁在設計階段屬性。Control designers use the RootDesigner property to access and manipulate the containing Web Forms page at design time.

給繼承者的注意事項

當您繼承自WebFormsRootDesigner類別,您必須覆寫下列成員:When you inherit from the WebFormsRootDesigner class, you must override the following members: - DocumentUrlIsDesignerViewLockedIsLoadingReferenceManagerSupportedTechnologies,和Verbs屬性。- The DocumentUrl, IsDesignerViewLocked, IsLoading, ReferenceManager, SupportedTechnologies, and Verbs properties.

- AddClientScriptToDocument(ClientScriptItem)AddControlToDocument(Control, Control, ControlLocation)GetClientScriptsInDocument()GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag),和RemoveControlFromDocument(Control)方法。- The AddClientScriptToDocument(ClientScriptItem), AddControlToDocument(Control, Control, ControlLocation), GetClientScriptsInDocument(), GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag), and RemoveControlFromDocument(Control) methods.

建構函式

WebFormsRootDesigner() WebFormsRootDesigner() WebFormsRootDesigner() WebFormsRootDesigner()

初始化 WebFormsRootDesigner 類別的新執行個體。Initializes a new instance of the WebFormsRootDesigner class.

屬性

Component Component Component Component

取得或設定這個設計工具正在設計的元件。Gets or sets the component that this designer is designing.

CurrentCulture CurrentCulture CurrentCulture CurrentCulture

取得目前執行緒的文化特性 (Culture) 資訊。Gets the culture information for the current thread.

DocumentUrl DocumentUrl DocumentUrl DocumentUrl

在衍生類別中覆寫時,取得 Web Form 網頁所在的 URL。When overridden in a derived class, gets the URL at which the Web Forms page is located.

IsDesignerViewLocked IsDesignerViewLocked IsDesignerViewLocked IsDesignerViewLocked

在衍生類別中覆寫時,取得值,指出是否鎖定了設計工具檢視。When overridden in a derived class, gets a value indicating whether the designer view is locked.

IsLoading IsLoading IsLoading IsLoading

在衍生類別中覆寫時,取得值,指出是否仍在載入 Web Form 網頁。When overridden in a derived class, gets a value indicating whether the Web Forms page is still loading.

ReferenceManager ReferenceManager ReferenceManager ReferenceManager

在衍生類別中覆寫時,取得具有目前 Web Form 網頁之相關資訊的 WebFormsReferenceManager 物件。When overridden in a derived class, gets a WebFormsReferenceManager object that has information about the current Web Forms page.

SupportedTechnologies SupportedTechnologies SupportedTechnologies SupportedTechnologies

取得技術的陣列,該設計工具元件可支援其顯示。Gets an array of technologies that the designer component can support for its display.

Verbs Verbs Verbs Verbs

取得設計工具所支援的設計階段動詞命令。Gets the design-time verbs that are supported by the designer.

方法

AddClientScriptToDocument(ClientScriptItem) AddClientScriptToDocument(ClientScriptItem) AddClientScriptToDocument(ClientScriptItem) AddClientScriptToDocument(ClientScriptItem)

在衍生類別中覆寫時,將用戶端指令碼項目加入目前的 Web Form 網頁。When overridden in a derived class, adds a client script element to the current Web Forms page.

AddControlToDocument(Control, Control, ControlLocation) AddControlToDocument(Control, Control, ControlLocation) AddControlToDocument(Control, Control, ControlLocation) AddControlToDocument(Control, Control, ControlLocation)

在衍生類別中覆寫時,將 Web 伺服器控制項加入 Web Form 網頁。When overridden in a derived class, adds a Web server control to the Web Forms page.

CreateDesignerActionService(IServiceProvider) CreateDesignerActionService(IServiceProvider) CreateDesignerActionService(IServiceProvider) CreateDesignerActionService(IServiceProvider)

傳回設計階段 DesignerActionService 物件。Returns a design-time DesignerActionService object.

CreateUrlResolutionService() CreateUrlResolutionService() CreateUrlResolutionService() CreateUrlResolutionService()

傳回解析相對 URL 的 IUrlResolutionServiceReturns an IUrlResolutionService that resolves relative URLs.

Dispose(Boolean) Dispose(Boolean) Dispose(Boolean) Dispose(Boolean)

釋放 WebFormsRootDesigner 所使用的 Unmanaged 資源,並選擇性釋放 Managed 資源。Releases the unmanaged resources that are used by the WebFormsRootDesigner and optionally releases the managed resources.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

在記憶體回收行程回收目前 WebFormsRootDesigner 物件的資源前,先將它的資源釋放。Frees the resources of the current WebFormsRootDesigner object before it is reclaimed by the garbage collector.

GenerateEmptyDesignTimeHtml(Control) GenerateEmptyDesignTimeHtml(Control) GenerateEmptyDesignTimeHtml(Control) GenerateEmptyDesignTimeHtml(Control)

在設計階段產生控制項的空白 HTML 標記。Generates empty HTML markup for a control at design time.

GenerateErrorDesignTimeHtml(Control, Exception, String) GenerateErrorDesignTimeHtml(Control, Exception, String) GenerateErrorDesignTimeHtml(Control, Exception, String) GenerateErrorDesignTimeHtml(Control, Exception, String)

產生 HTML 標記,其可透過使用指定的控制項、例外狀況 (Exception) 和訊息在設計階段顯示錯誤訊息。Generates HTML markup that is used to display an error message at design time by using the specified control, exception, and message.

GetClientScriptsInDocument() GetClientScriptsInDocument() GetClientScriptsInDocument() GetClientScriptsInDocument()

在衍生類別中覆寫時,傳回包含網頁上所有用戶端指令碼項目的 ClientScriptItemCollection 物件。When overridden in a derived class, returns a ClientScriptItemCollection object that contains all client script items that are on the page.

GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag) GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag) GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag) GetControlViewAndTag(Control, IControlDesignerView, IControlDesignerTag)

在衍生類別中覆寫時,傳回目前的設計階段檢視以及指定之控制項的 HTML 標記。When overridden in a derived class, returns both the current design-time view and the HTML markup for the specified control.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

做為預設雜湊函式。Serves as the default hash function.

(Inherited from Object)
GetService(Type) GetService(Type) GetService(Type) GetService(Type)

傳回所要求的服務。Returns the requested service.

GetType() GetType() GetType() GetType()

取得目前執行個體的 TypeGets the Type of the current instance.

(Inherited from Object)
GetView(ViewTechnology) GetView(ViewTechnology) GetView(ViewTechnology) GetView(ViewTechnology)

傳回由所提供之 ViewTechnology 物件決定的檢視物件。Returns a view object that is determined by the provided ViewTechnology object.

Initialize(IComponent) Initialize(IComponent) Initialize(IComponent) Initialize(IComponent)

使用指定的元件初始化 WebFormsRootDesigner 物件。Initializes the WebFormsRootDesigner object using the specified component.

MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

建立目前 Object 的淺層複本 (Shallow Copy)。Creates a shallow copy of the current Object.

(Inherited from Object)
OnLoadComplete(EventArgs) OnLoadComplete(EventArgs) OnLoadComplete(EventArgs) OnLoadComplete(EventArgs)

當 Web Form 網頁完全載入時,引發 LoadComplete 事件。Raises the LoadComplete event when the Web Forms page is completely loaded.

PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary) PostFilterAttributes(IDictionary)

允許設計工具變更或移除其透過 TypeDescriptor 物件所公開 (Expose) 之屬性集中的項目。Allows a designer to change or remove items from the set of attributes that the designer exposes through a TypeDescriptor object.

PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) PostFilterEvents(IDictionary) PostFilterEvents(IDictionary)

允許設計工具變更或移除其透過 TypeDescriptor 物件所公開之事件集中的項目。Allows a designer to change or remove items from the set of events that the designer exposes through a TypeDescriptor object.

PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) PostFilterProperties(IDictionary) PostFilterProperties(IDictionary)

允許設計工具變更或移除其透過 TypeDescriptor 物件所公開之屬性集中的項目。Allows a designer to change or remove items from the set of properties that the designer exposes through a TypeDescriptor object.

PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary) PreFilterAttributes(IDictionary)

允許設計工具加入至其透過 TypeDescriptor 物件所公開的屬性集。Allows a designer to add to the set of attributes that the designer exposes through a TypeDescriptor object.

PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) PreFilterEvents(IDictionary) PreFilterEvents(IDictionary)

允許設計工具將項目加入至其透過 TypeDescriptor 物件所公開的事件集。Allows a designer to add items to the set of events that the designer exposes through a TypeDescriptor object.

PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) PreFilterProperties(IDictionary) PreFilterProperties(IDictionary)

允許設計工具將項目加入至其透過 TypeDescriptor 物件所公開的屬性集。Allows a designer to add items to the set of properties that the designer exposes through a TypeDescriptor object.

RemoveClientScriptFromDocument(String) RemoveClientScriptFromDocument(String) RemoveClientScriptFromDocument(String) RemoveClientScriptFromDocument(String)

在設計階段移除文件中的指定用戶端指令碼。Removes the specified client script from the document at design time.

RemoveControlFromDocument(Control) RemoveControlFromDocument(Control) RemoveControlFromDocument(Control) RemoveControlFromDocument(Control)

在衍生類別中覆寫時,從 Web Form 網頁移除指定的控制項。When overridden in a derived class, removes the specified control from the Web Forms page.

ResolveUrl(String) ResolveUrl(String) ResolveUrl(String) ResolveUrl(String)

將相對 URL 轉換為完整的 URL。Converts a relative URL into a fully qualified URL.

SetControlID(Control, String) SetControlID(Control, String) SetControlID(Control, String) SetControlID(Control, String)

使用指定的字串,設定指定之控制項的 ID 屬性。Sets the ID property of the specified control with the specified string.

ToString() ToString() ToString() ToString()

傳回代表目前物件的字串。Returns a string that represents the current object.

(Inherited from Object)

事件

LoadComplete LoadComplete LoadComplete LoadComplete

發生於設計工具完成 Web Form 網頁的載入時。Occurs when the designer completes loading the Web Forms page.

明確介面實作

IDesigner.DoDefaultAction() IDesigner.DoDefaultAction() IDesigner.DoDefaultAction() IDesigner.DoDefaultAction()

如需這個成員的說明,請參閱 DoDefaultAction()For a description of this member, see DoDefaultAction().

IDesigner.Verbs IDesigner.Verbs IDesigner.Verbs IDesigner.Verbs

取得或設定設計工具所支援的設計階段動詞命令。Gets or sets the design-time verbs that are supported by the designer. 如需這個成員的說明,請參閱 VerbsFor a description of this member, see Verbs.

IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary) IDesignerFilter.PostFilterAttributes(IDictionary)

如需這個成員的說明,請參閱 PostFilterAttributes(IDictionary)For a description of this member, see PostFilterAttributes(IDictionary).

IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary) IDesignerFilter.PostFilterEvents(IDictionary)

如需這個成員的說明,請參閱 PostFilterEvents(IDictionary)For a description of this member, see PostFilterEvents(IDictionary).

IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary) IDesignerFilter.PostFilterProperties(IDictionary)

如需這個成員的說明,請參閱 PostFilterProperties(IDictionary)For a description of this member, see PostFilterProperties(IDictionary).

IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary) IDesignerFilter.PreFilterAttributes(IDictionary)

如需這個成員的說明,請參閱 PreFilterAttributes(IDictionary)For a description of this member, see PreFilterAttributes(IDictionary).

IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary) IDesignerFilter.PreFilterEvents(IDictionary)

如需這個成員的說明,請參閱 PreFilterEvents(IDictionary)For a description of this member, see PreFilterEvents(IDictionary).

IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary) IDesignerFilter.PreFilterProperties(IDictionary)

如需這個成員的說明,請參閱 PreFilterProperties(IDictionary)For a description of this member, see PreFilterProperties(IDictionary).

IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose() IDisposable.Dispose()

如需這個成員的說明,請參閱 Dispose()For a description of this member, see Dispose().

IRootDesigner.GetView(ViewTechnology) IRootDesigner.GetView(ViewTechnology) IRootDesigner.GetView(ViewTechnology) IRootDesigner.GetView(ViewTechnology)

取得指定的檢視技術之檢視物件。Gets a view object for the specified view technology. 如需這個成員的說明,請參閱 GetView(ViewTechnology)For a description of this member, see GetView(ViewTechnology).

IRootDesigner.SupportedTechnologies IRootDesigner.SupportedTechnologies IRootDesigner.SupportedTechnologies IRootDesigner.SupportedTechnologies

取得技術的陣列,該設計工具元件可支援其顯示。Gets an array of technologies that the designer component can support for its display. 如需這個成員的說明,請參閱 SupportedTechnologiesFor a description of this member, see SupportedTechnologies.

適用於

另請參閱