TemplateControl.LoadControl Method (Type, Object())


The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Loads a Control object based on a specified type and constructor parameters.

Namespace:   System.Web.UI
Assembly:  System.Web (in System.Web.dll)

Public Function LoadControl (
	t As Type,
	parameters As Object()
) As Control


Type: System.Type

The type of the control.

Type: System.Object()

An array of arguments that match in number, order, and type the parameters of the constructor to invoke. If parameters is an empty array or null, the constructor that takes no parameters (the default constructor) is invoked.

Return Value

Type: System.Web.UI.Control

Returns the specified UserControl.

If the user control supports caching, the object returned from the LoadControl method is not actually a UserControl object; rather, it is a PartialCachingControl object.

When you load a control into a container control, the container raises all of the added control's events until it has caught up to the current event. However, the added control does not catch up with postback data processing. For an added control to participate in postback data processing, including validation, the control must be added in the Init event rather than in the Load event.

.NET Framework
Available since 2.0
Return to top