TemplateControl.LoadControl TemplateControl.LoadControl TemplateControl.LoadControl TemplateControl.LoadControl Method

Definición

Carga un objeto Control.Loads a Control.

Sobrecargas

LoadControl(String) LoadControl(String) LoadControl(String) LoadControl(String)

Carga un objeto Control de un archivo basado en una ruta de acceso virtual especificada.Loads a Control object from a file based on a specified virtual path.

LoadControl(Type, Object[]) LoadControl(Type, Object[]) LoadControl(Type, Object[]) LoadControl(Type, Object[])

Carga un objeto Control basado en un tipo especificado y en parámetros de constructor.Loads a Control object based on a specified type and constructor parameters.

Comentarios

Cuando se carga un control en un control contenedor, el contenedor genera todos los eventos del control agregado hasta que se detecta hasta el evento actual.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. Sin embargo, el control agregado no se pone al día con el procesamiento de datos de postback.However, the added control does not catch up with postback data processing. Para que un control agregado participe en el procesamiento de datos de postback, incluida la validación, el Init control debe agregarse en Load el evento en lugar de en el evento.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.

LoadControl(String) LoadControl(String) LoadControl(String) LoadControl(String)

Carga un objeto Control de un archivo basado en una ruta de acceso virtual especificada.Loads a Control object from a file based on a specified virtual path.

public:
 System::Web::UI::Control ^ LoadControl(System::String ^ virtualPath);
public System.Web.UI.Control LoadControl (string virtualPath);
member this.LoadControl : string -> System.Web.UI.Control
Public Function LoadControl (virtualPath As String) As Control

Parámetros

virtualPath
String String String String

Ruta de acceso virtual a un archivo de controles.The virtual path to a control file.

Devoluciones

Devuelve la Control especificada.Returns the specified Control.

Excepciones

La ruta de acceso virtual es null o está vacía.The virtual path is null or empty.

Ejemplos

En el ejemplo de código siguiente se muestra cómo LoadControl utilizar el método para agregar un control de usuario a una página ASP.net.The following code example demonstrates how to use the LoadControl method to add a user control to an ASP.NET page.

En el OnInit método de evento, esta página usa LoadControl el método para crear mediante programación un control de usuario en la página.In the OnInit event method, this page uses the LoadControl method to programmatically create a user control on the page. El método agrega el control a la Controls propiedad de un PlaceHolder control de servidor Web Placeholder1denominado.The method adds the control to the Controls property of a PlaceHolder Web server control named Placeholder1.

Para obtener la definición de MyControl la clase que se usa en este ejemplo de código TemplateControl, vea.For the definition of the MyControl class that is used in this code example, see TemplateControl.

void Page_Init(object sender, System.EventArgs e)
{
    // Instantiate the UserControl object
    MyControl myControl1 =
        (MyControl)LoadControl("TempControl_Samples1.ascx.cs");
    PlaceHolder1.Controls.Add(myControl1);
}
Sub Page_Load(ByVal Sender As Object, ByVal e As EventArgs)
    ' Obtain a UserControl object MyControl from the
    ' user control file TempControl_Samples1.ascx.vb
    Dim myControl1 As MyControl = CType(LoadControl("TempControl_Samples1.vb.ascx"), MyControl)
    Controls.Add(myControl1)
End Sub

Comentarios

Si el control admite el almacenamiento en caché, el objeto LoadControl devuelto por el método Control no es realmente un objeto; en PartialCachingControl su lugar, es un objeto.If the control supports caching, the object returned from the LoadControl method is not actually a Control object; rather, it is a PartialCachingControl object. Si el virtualPath parámetro es relativo, la ruta de acceso del control cargado es relativa a la ruta TemplateControlde acceso de.If the virtualPath parameter is relative, the path of the loaded control is relative to the path of the TemplateControl.

Cuando se carga un control en un control contenedor, el contenedor genera todos los eventos del control agregado hasta que se detecta hasta el evento actual.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. Sin embargo, el control agregado no se pone al día con el procesamiento de datos de postback.However, the added control does not catch up with postback data processing. Para que un control agregado participe en el procesamiento de datos de postback, incluida la validación, el Init control debe agregarse en Load el evento en lugar de en el evento.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.

Consulte también:

LoadControl(Type, Object[]) LoadControl(Type, Object[]) LoadControl(Type, Object[]) LoadControl(Type, Object[])

Carga un objeto Control basado en un tipo especificado y en parámetros de constructor.Loads a Control object based on a specified type and constructor parameters.

public:
 System::Web::UI::Control ^ LoadControl(Type ^ t, cli::array <System::Object ^> ^ parameters);
public System.Web.UI.Control LoadControl (Type t, object[] parameters);
member this.LoadControl : Type * obj[] -> System.Web.UI.Control
Public Function LoadControl (t As Type, parameters As Object()) As Control

Parámetros

t
Type Type Type Type

Tipo del control.The type of the control.

parameters
Object[]

Matriz de argumentos que coinciden en número, orden y tipo con los parámetros del constructor al que se llama.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Si parameters es una matriz vacía o null, se invoca al constructor que no toma parámetros (constructor sin parámetros).If parameters is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

Devoluciones

Devuelve la UserControl especificada.Returns the specified UserControl.

Comentarios

Si el control de usuario admite el almacenamiento en caché, el LoadControl objeto devuelto por el UserControl método no es realmente un objeto; PartialCachingControl en su lugar, es un objeto.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.

Cuando se carga un control en un control contenedor, el contenedor genera todos los eventos del control agregado hasta que se detecta hasta el evento actual.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. Sin embargo, el control agregado no se pone al día con el procesamiento de datos de postback.However, the added control does not catch up with postback data processing. Para que un control agregado participe en el procesamiento de datos de postback, incluida la validación, el Init control debe agregarse en Load el evento en lugar de en el evento.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.

Consulte también:

Se aplica a