TemplateControl.LoadControl Metoda

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

Návraty

Vrátí zadanou Controlhodnotu .

Výjimky

Příklady

Následující příklad kódu ukazuje, jak použít metodu LoadControl k přidání uživatelského ovládacího prvku na ASP.NET stránce.

OnInit V metodě události tato stránka používá metodu LoadControl k programovému vytvoření uživatelského ovládacího prvku na stránce. Metoda přidá ovládací prvek do Controls vlastnosti ovládacího prvku webového PlaceHolder serveru s názvem Placeholder1.

Definici MyControl třídy, která se používá v tomto příkladu kódu, najdete v tématu 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ý metodou LoadControl není ve skutečnosti objektem Control , ale objektem PartialCachingControl . virtualPath Pokud je parametr relativní, je cesta načteného ovládacího prvku relativní k cestě TemplateControlk .

Když načtete ovládací prvek do ovládacího prvku kontejneru, kontejner vyvolá všechny události přidaného ovládacího prvku, dokud se nedohodí k aktuální události. Přidaný ovládací prvek však nedohoní zpracování dat zpětného odeslání. Aby se přidaný ovládací prvek podílel na zpracování dat zpětného odeslání, včetně ověření, musí být tento ovládací prvek přidán do Init události, nikoli do Load události.

Viz také

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• ASP.NET přehled životního cyklu stránky

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

Návraty

Vrátí zadanou UserControlhodnotu .

Poznámky

Pokud uživatelský ovládací prvek podporuje ukládání do mezipaměti, objekt vrácený metodou LoadControl není ve skutečnosti objektem UserControl , ale objektem PartialCachingControl .

Když načtete ovládací prvek do ovládacího prvku kontejneru, kontejner vyvolá všechny události přidaného ovládacího prvku, dokud se nedohodí k aktuální události. Přidaný ovládací prvek však nedohoní zpracování dat zpětného odeslání. Aby se přidaný ovládací prvek podílel na zpracování dat zpětného odeslání, včetně ověření, musí být tento ovládací prvek přidán do Init události, nikoli do Load události.

Viz také

• UserControl
• LoadControl(String)
• OnInit(EventArgs)
• OnLoad(EventArgs)
• ASP.NET přehled životního cyklu stránky