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

Parameter

Gibt zurück

Gibt die angegebene Control zurück.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird veranschaulicht, wie Sie mit der LoadControl -Methode einer ASP.NET Seite ein Benutzersteuerelement hinzufügen.

In der OnInit Ereignismethode verwendet diese Seite die LoadControl -Methode, um programmgesteuert ein Benutzersteuerelement auf der Seite zu erstellen. Die -Methode fügt das -Steuerelement der Controls -Eigenschaft eines PlaceHolder Webserversteuerelements mit dem Namen Placeholder1hinzu.

Die Definition der Klasse, die MyControl in diesem Codebeispiel verwendet wird, finden Sie unter 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

Hinweise

Wenn das Steuerelement die Zwischenspeicherung unterstützt, ist das von der LoadControl -Methode zurückgegebene Objekt eigentlich Control kein Objekt, sondern vielmehr ein PartialCachingControl -Objekt. Wenn der virtualPath Parameter relativ ist, ist der Pfad des geladenen Steuerelements relativ zum Pfad von TemplateControl.

Wenn Sie ein Steuerelement in ein Containersteuerelement laden, löst der Container alle Ereignisse des hinzugefügten Steuerelements aus, bis es das aktuelle Ereignis aufgeholt hat. Das hinzugefügte Steuerelement kann die Postbackdatenverarbeitung jedoch nicht nachholen. Damit ein hinzugefügtes Steuerelement an der Postbackdatenverarbeitung teilnehmen kann, einschließlich der Überprüfung, muss das Steuerelement im Init -Ereignis und nicht im Load -Ereignis hinzugefügt werden.

Weitere Informationen

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• Übersicht über den Lebenszyklus der ASP.NET Seite

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

Parameter

Gibt zurück

Gibt die angegebene UserControl zurück.

Hinweise

Wenn das Benutzersteuerelement die Zwischenspeicherung unterstützt, ist das von der LoadControl -Methode zurückgegebene Objekt kein UserControl Objekt, sondern ein PartialCachingControl -Objekt.

Wenn Sie ein Steuerelement in ein Containersteuerelement laden, löst der Container alle Ereignisse des hinzugefügten Steuerelements aus, bis es das aktuelle Ereignis aufgeholt hat. Das hinzugefügte Steuerelement kann die Postbackdatenverarbeitung jedoch nicht nachholen. Damit ein hinzugefügtes Steuerelement an der Postbackdatenverarbeitung teilnehmen kann, einschließlich der Überprüfung, muss das Steuerelement im Init -Ereignis und nicht im Load -Ereignis hinzugefügt werden.

Weitere Informationen

• UserControl
• LoadControl(String)
• OnInit(EventArgs)
• OnLoad(EventArgs)
• Übersicht über den Lebenszyklus der ASP.NET Seite