TemplateControl.LoadControl Methode

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

Parameters

Retouren

Retourneert de opgegeven Control.

Uitzonderingen

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de methode LoadControl gebruikt om een gebruikersbeheer toe te voegen aan een ASP.NET pagina.

In de OnInit gebeurtenismethode gebruikt deze pagina de LoadControl methode om programmatisch een gebruikersbeheer op de pagina te maken. Met de methode wordt het besturingselement toegevoegd aan de eigenschap van een PlaceHolder webserverbesturingselement met de Controls naam Placeholder1.

Zie voor de definitie van de MyControl klasse die in dit codevoorbeeld TemplateControlwordt gebruikt.

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

Opmerkingen

Als het besturingselement caching ondersteunt, is het object dat door de LoadControl methode wordt geretourneerd, niet daadwerkelijk een Control object. In plaats daarvan is het een PartialCachingControl object. Als de virtualPath parameter relatief is, is het pad van het geladen besturingselement relatief ten opzichte van het pad van de TemplateControl.

Wanneer u een besturingselement in een containerbeheer laadt, worden alle gebeurtenissen van het toegevoegde besturingselement gegenereerd totdat het is opgevangen bij de huidige gebeurtenis. Het toegevoegde besturingselement kan echter niet worden ingehaald met gegevensverwerking na het terugdraaien. Voor een toegevoegd besturingselement om deel te nemen aan de verwerking van gegevens na een terugval, inclusief validatie, moet het besturingselement worden toegevoegd in de Init gebeurtenis in plaats van in de Load gebeurtenis.

Zie ook

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• overzicht van ASP.NET paginalevenscyclus

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

Parameters

Retouren

Retourneert de opgegeven UserControl.

Opmerkingen

Als het besturingselement van de gebruiker caching ondersteunt, is het object dat wordt geretourneerd door de LoadControl methode niet daadwerkelijk een UserControl object; in plaats daarvan is het een PartialCachingControl object.

Wanneer u een besturingselement in een containerbeheer laadt, worden alle gebeurtenissen van het toegevoegde besturingselement gegenereerd totdat het is opgevangen bij de huidige gebeurtenis. Het toegevoegde besturingselement kan echter niet worden ingehaald met gegevensverwerking na het terugdraaien. Voor een toegevoegd besturingselement om deel te nemen aan de verwerking van gegevens na een terugval, inclusief validatie, moet het besturingselement worden toegevoegd in de Init gebeurtenis in plaats van in de Load gebeurtenis.

Zie ook

• UserControl
• LoadControl(String)
• OnInit(EventArgs)
• OnLoad(EventArgs)
• overzicht van ASP.NET paginalevenscyclus