Sdílet prostřednictvím

TemplateControl.LoadControl Metoda

Definice

Obor názvů:
System.Web.UI
Sestavení:
System.Web.dll

Načte .Control

Přetížení

Name Description
LoadControl(String)

Načte Control objekt ze souboru na základě zadané virtuální cesty.
LoadControl(Type, Object[])

Načte Control objekt na základě zadaného typu a parametrů konstruktoru.

Poznámky

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 neuchytí aktuální událost. Přidaný ovládací prvek však nechytí zpracování dat postback. Aby se přidal ovládací prvek pro účast v následném zpracování dat, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.

LoadControl(String)

Načte Control objekt ze souboru na základě zadané virtuální cesty.

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.

Návraty

Control

Vrátí zadanou Controlhodnotu .

Výjimky

ArgumentNullException

Virtuální cesta je nebo je null prázdná.

Příklady

Následující příklad kódu ukazuje, jak pomocí LoadControl metody přidat uživatelský ovládací prvek na ASP.NET stránku.

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.

Definice třídy, která se používá v tomto příkladu MyControl kódu, naleznete 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ý z LoadControl metody není ve skutečnosti objekt, Control spíše je PartialCachingControl to objekt. virtualPath Pokud je parametr relativní, cesta načteného ovládacího prvku je relativní vzhledem k cestě ovládacího TemplateControlprvku .

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 neuchytí aktuální událost. Přidaný ovládací prvek však nechytí zpracování dat postback. Aby se přidal ovládací prvek pro účast v následném zpracování dat, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.

Viz také

Platí pro

LoadControl(Type, Object[])

Načte Control objekt na základě zadaného typu a parametrů konstruktoru.

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 prvku.

parameters
Object[]

Pole argumentů, které se shodují s číslem, pořadím a zadáním parametrů konstruktoru, které se mají vyvolat. Je-li parameters prázdné pole nebo null, konstruktor, který nepřijímá žádné parametry (konstruktor bez parametrů) je vyvolán.

Návraty

Control

Vrátí zadanou UserControlhodnotu .

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, spíše se jedná o PartialCachingControl objekt.

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 neuchytí aktuální událost. Přidaný ovládací prvek však nechytí zpracování dat postback. Aby se přidal ovládací prvek pro účast v následném zpracování dat, včetně ověření, musí být ovládací prvek přidán v Init události, nikoli v Load události.

Viz také

Platí pro