Sdílet prostřednictvím

TemplateControl.LoadControl Metoda

  • Reference

Definice

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

Načte .Control

Přetížení

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

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 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é

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é odpovídají číslu, pořadí a typu parametry konstruktoru, který se má vyvolat. Pokud parameters je prázdné pole nebo null, je vyvolán konstruktor, který nepřijímá žádné parametry (konstruktor bez parametrů).

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ý 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é

Platí pro