This documentation is archived and is not being maintained.

UserControl Methods

The methods of the UserControl class are listed here. For a complete list of UserControl class members, see the UserControl Members topic.

Public Methods

public methodDataBind (inherited from Control) Binds a data source to the invoked server control and all its child controls.
public methodDesignerInitialize Performs any initialization steps on the user control that are required by RAD designers.
public methodDispose (inherited from Control) Enables a server control to perform final clean up before it is released from memory.
public methodEquals (inherited from Object) Overloaded. Determines whether two Object instances are equal.
public methodFindControl (inherited from Control) Overloaded. Searches the current naming container for the specified server control.
public methodGetHashCode (inherited from Object) Serves as a hash function for a particular type, suitable for use in hashing algorithms and data structures like a hash table.
public methodGetType (inherited from Object) Gets the Type of the current instance.
public methodHasControls (inherited from Control) Determines if the server control contains any child controls.
public methodInitializeAsUserControl Initializes the UserControl object that has been created declaratively. Since there are some differences between pages and user controls, this method makes sure that the user control is initialized properly.
public methodLoadControl (inherited from TemplateControl) Obtains a UserControl object from a user control file.
public methodLoadTemplate (inherited from TemplateControl) Obtains an instance of the ITemplate interface from an external file.
public methodMapPath Assigns a virtual file path, either absolute or relative, to a physical file path.
public methodParseControl (inherited from TemplateControl) Parses an input string into a Control on the Web Forms page or user control.
public methodRenderControl (inherited from Control) Outputs server control content to a provided HtmlTextWriter object and stores tracing information about the control if tracing is enabled.
public methodResolveUrl (inherited from Control) Converts a URL into one that is usable on the requesting client.
public methodToString (inherited from Object) Returns a String that represents the current Object.

Protected Methods

protected methodAddedControl (inherited from Control) Called after a control is added to the Controls collection of another control.
protected methodAddParsedSubObject (inherited from Control) Notifies the server control that an element, either XML or HTML, was parsed, and adds the element to the server control's ControlCollection object.
protected methodClearChildViewState (inherited from Control) Deletes the view-state information for all the server control's child controls.
protected methodConstruct (inherited from TemplateControl) Performs construction time logic.
protected methodCreateChildControls (inherited from Control) Notifies server controls that use composition-based implementation to create any child controls they contain in preparation for posting back or rendering.
protected methodCreateControlCollection (inherited from Control) Creates a new ControlCollection object to hold the child controls (both literal and server) of the server control.
protected methodEnsureChildControls (inherited from Control) Determines whether the server control contains child controls. If it does not, it creates child controls.
protected methodFinalize (inherited from Object) Overridden. Allows an Object to attempt to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection.

In C# and C++, finalizers are expressed using destructor syntax.

protected methodIsLiteralContent (inherited from Control) Determines if the server control holds only literal content.
protected methodLoadViewState Overridden. Restores the view-state information from a previous user control request that was saved by the SaveViewState method.
protected methodMapPathSecure (inherited from Control) Retrieves the physical path that a virtual path, either absolute or relative, maps to.
protected methodMemberwiseClone (inherited from Object) Creates a shallow copy of the current Object.
protected methodOnAbortTransaction (inherited from TemplateControl) Raises the AbortTransaction event.
protected methodOnBubbleEvent (inherited from Control) Determines whether the event for the server control is passed up the page's UI server control hierarchy.
protected methodOnCommitTransaction (inherited from TemplateControl) Raises the CommitTransaction event.
protected methodOnDataBinding (inherited from Control) Raises the DataBinding event.
protected methodOnError (inherited from TemplateControl) Raises the Error event.
protected methodOnInit Overridden. Raises the Init event.
protected methodOnLoad (inherited from Control) Raises the Load event.
protected methodOnPreRender (inherited from Control) Raises the PreRender event.
protected methodOnUnload (inherited from Control) Raises the Unload event.
Note   Server controls should perform any final cleanup, such as closing files, closing database connections, and discarding objects, during this stage of the server control lifecycle.
protected methodRaiseBubbleEvent (inherited from Control) Assigns any sources of the event and its information to the control's parent.
protected methodRemovedControl (inherited from Control) Called after a control is removed from the Controls collection of another control.
protected methodRender (inherited from Control) Sends server control content to a provided HtmlTextWriter object, which writes the content to be rendered on the client.
protected methodRenderChildren (inherited from Control) Outputs the content of a server control's children to a provided HtmlTextWriter object, which writes the content to be rendered on the client.
protected methodSaveViewState Overridden. Saves any user control view-state changes that have occurred since the last page postback.
protected methodTrackViewState (inherited from Control) Causes tracking of view-state changes to the server control so they can be stored in the server control's StateBag object. This object is accessible through the Control.ViewState property.

See Also

UserControl Class | System.Web.UI Namespace

Show: