TemplateControl.LoadControl Metod

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

Parametrar

Returer

Returnerar den angivna Control.

Undantag

Exempel

Följande kodexempel visar hur du använder metoden LoadControl för att lägga till en användarkontroll på en ASP.NET sida.

OnInit I händelsemetoden använder den LoadControl här sidan metoden för att programmatiskt skapa en användarkontroll på sidan. Metoden lägger till kontrollen i Controls egenskapen för en PlaceHolder webbserverkontroll med namnet Placeholder1.

Definitionen av klassen MyControl som används i det här kodexemplet TemplateControlfinns i .

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

Kommentarer

Om kontrollen stöder cachelagring är det objekt som returneras från LoadControl metoden faktiskt inte ett Control objekt. I stället är det ett PartialCachingControl objekt. Om parametern virtualPath är relativ är sökvägen till den inlästa kontrollen relativ till sökvägen TemplateControltill .

När du läser in en kontroll i en containerkontroll genererar containern alla händelser för den tillagda kontrollen tills den har kommit ikapp den aktuella händelsen. Den tillagda kontrollen kommer dock inte ikapp databearbetningen efter återställningen. För att en ytterligare kontroll ska kunna delta i databearbetning efter återställning, inklusive validering, måste kontrollen läggas till i händelsen i Init stället för i händelsen Load .

Se även

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• översikt över ASP.NET sidlivscykel

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

Parametrar

Returer

Returnerar den angivna UserControl.

Kommentarer

Om användarkontrollen stöder cachelagring är det objekt som returneras från LoadControl metoden faktiskt inte ett UserControl objekt. Det är i stället ett PartialCachingControl objekt.

När du läser in en kontroll i en containerkontroll genererar containern alla händelser för den tillagda kontrollen tills den har kommit ikapp den aktuella händelsen. Den tillagda kontrollen kommer dock inte ikapp databearbetningen efter återställningen. För att en ytterligare kontroll ska kunna delta i databearbetning efter återställning, inklusive validering, måste kontrollen läggas till i händelsen i Init stället för i händelsen Load .

Se även

• UserControl
• LoadControl(String)
• OnInit(EventArgs)
• OnLoad(EventArgs)
• översikt över ASP.NET sidlivscykel