TemplateControl.LoadControl Metoda

Definice

Načte Control .Loads a Control.

Přetížení

LoadControl(String)

Načte Control objekt ze souboru na základě zadané virtuální cesty.Loads a Control object from a file based on a specified virtual path.

LoadControl(Type, Object[])

Načte Control objekt na základě zadaného typu a parametrů konstruktoru.Loads a Control object based on a specified type and constructor parameters.

Poznámky

Když nahrajete ovládací prvek do ovládacího prvku kontejneru, kontejner vyvolá všechny události přidávaného ovládacího prvku, dokud nezachycuje aktuální událost.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. Přidaný ovládací prvek však není zachytí se zpracováním dat postback.However, the added control does not catch up with postback data processing. Aby byl přidaný ovládací prvek součástí zpracování dat zpětného volání, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.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)

Načte Control objekt ze souboru na základě zadané virtuální cesty.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

Parametry

virtualPath
String

Virtuální cesta k řídicímu souboru.The virtual path to a control file.

Návraty

Control

Vrátí zadanou hodnotu Control .Returns the specified Control.

Výjimky

Virtuální cesta je null nebo je prázdná.The virtual path is null or empty.

Příklady

Následující příklad kódu ukazuje, jak použít LoadControl metodu pro přidání uživatelského ovládacího prvku na stránku ASP.NET.The following code example demonstrates how to use the LoadControl method to add a user control to an ASP.NET page.

V OnInit metodě události Tato stránka používá LoadControl metodu pro programové vytvoření uživatelského ovládacího prvku na stránce.In the OnInit event method, this page uses the LoadControl method to programmatically create a user control on the page. Metoda přidá ovládací prvek do Controls vlastnosti PlaceHolder ovládacího prvku webového serveru s názvem Placeholder1 .The method adds the control to the Controls property of a PlaceHolder Web server control named Placeholder1.

Definice MyControl třídy, která je použita v tomto příkladu kódu, naleznete v tématu TemplateControl .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

Poznámky

Pokud ovládací prvek podporuje ukládání do mezipaměti, objekt vrácený z LoadControl metody není ve skutečnosti Control objekt. místo toho je PartialCachingControl objekt.If the control supports caching, the object returned from the LoadControl method is not actually a Control object; rather, it is a PartialCachingControl object. Pokud virtualPath je parametr relativní, cesta načteného ovládacího prvku je relativní vzhledem k cestě TemplateControl .If the virtualPath parameter is relative, the path of the loaded control is relative to the path of the TemplateControl.

Když nahrajete ovládací prvek do ovládacího prvku kontejneru, kontejner vyvolá všechny události přidávaného ovládacího prvku, dokud nezachycuje aktuální událost.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. Přidaný ovládací prvek však není zachytí se zpracováním dat postback.However, the added control does not catch up with postback data processing. Aby byl přidaný ovládací prvek součástí zpracování dat zpětného volání, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.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.

Viz také

Platí pro

LoadControl(Type, Object[])

Načte Control objekt na základě zadaného typu a parametrů konstruktoru.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

Parametry

t
Type

Typ ovládacího prvkuThe type of the control.

parameters
Object[]

Pole argumentů, které se shodují s číslem, pořadím a typem parametrů konstruktoru, který se má vyvolat.An array of arguments that match in number, order, and type the parameters of the constructor to invoke. Pokud parameters je prázdné pole nebo null , konstruktor, který nepřijímá žádné parametry (konstruktor bez parametrů), je vyvolán.If parameters is an empty array or null, the constructor that takes no parameters (the parameterless constructor) is invoked.

Návraty

Control

Vrátí zadanou hodnotu UserControl .Returns the specified UserControl.

Poznámky

Pokud uživatelský ovládací prvek podporuje ukládání do mezipaměti, objekt vrácený z LoadControl metody není ve skutečnosti UserControl objekt. místo toho je PartialCachingControl objekt.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.

Když nahrajete ovládací prvek do ovládacího prvku kontejneru, kontejner vyvolá všechny události přidávaného ovládacího prvku, dokud nezachycuje aktuální událost.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. Přidaný ovládací prvek však není zachytí se zpracováním dat postback.However, the added control does not catch up with postback data processing. Aby byl přidaný ovládací prvek součástí zpracování dat zpětného volání, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.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.

Viz také

Platí pro