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 den angegebenen ControlWert zurück.

Ausnahmen

Beispiele

Im folgenden Codebeispiel wird die Verwendung der LoadControl Methode zum Hinzufügen eines Benutzersteuerelements zu einer ASP.NET Seite veranschaulicht.

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

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 das Zwischenspeichern unterstützt, ist das von der LoadControl Methode zurückgegebene Objekt nicht tatsächlich ein Control Objekt. Stattdessen handelt es sich um ein PartialCachingControl Objekt. Wenn der virtualPath Parameter relativ ist, ist der Pfad des geladenen Steuerelements relativ zum Pfad des 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 erfasst hat. Das hinzugefügte Steuerelement erfasst jedoch nicht die Postbackdatenverarbeitung. Damit ein hinzugefügtes Steuerelement an der Postbackdatenverarbeitung teilnimmt, einschließlich der Validierung, muss das Steuerelement nicht im Ereignis, sondern im InitLoad Ereignis hinzugefügt werden.

Weitere Informationen

• UserControl
• LoadControl(Type, Object[])
• OnInit(EventArgs)
• OnLoad(EventArgs)
• Übersicht über den Lebenszyklus 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 den angegebenen UserControlWert zurück.

Hinweise

Wenn das Benutzersteuerelement das Zwischenspeichern unterstützt, ist das von der LoadControl Methode zurückgegebene Objekt nicht tatsächlich ein 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 erfasst hat. Das hinzugefügte Steuerelement erfasst jedoch nicht die Postbackdatenverarbeitung. Damit ein hinzugefügtes Steuerelement an der Postbackdatenverarbeitung teilnimmt, einschließlich der Validierung, muss das Steuerelement nicht im Ereignis, sondern im InitLoad Ereignis hinzugefügt werden.

Weitere Informationen

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