Freigeben über

TemplateControl.LoadControl Methode

  • Referenz

Definition

Namespace:
System.Web.UI
Assembly:
System.Web.dll

Lädt ein Control.

Überlädt

LoadControl(String)

Lädt ein Control-Objekt aus einer Datei auf der Grundlage eines angegebenen virtuellen Pfads.
LoadControl(Type, Object[])

Lädt auf der Grundlage eines angegebenen Typs und der angegebenen Konstruktorparameter ein Control-Objekt.

Hinweise

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.

LoadControl(String)

Lädt ein Control-Objekt aus einer Datei auf der Grundlage eines angegebenen virtuellen Pfads.

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

virtualPath
String

Der virtuelle Pfad einer Steuerelementdatei.

Gibt zurück

Control

Gibt die angegebene Control zurück.

Ausnahmen

ArgumentNullException

Der virtuelle Pfad ist null oder leer.

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

Gilt für:

LoadControl(Type, Object[])

Lädt auf der Grundlage eines angegebenen Typs und der angegebenen Konstruktorparameter ein Control-Objekt.

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

t
Type

Der Typ des Steuerelements.

parameters
Object[]

Ein Array von Argumenten, das im Hinblick auf Anzahl, Reihenfolge und Typ mit den Parametern des aufzurufenden Konstruktors übereinstimmt. Wenn parameters ein leeres Array oder null ist, wird der (parameterlose) Konstruktor aufgerufen, der keine Parameter akzeptiert.

Gibt zurück

Control

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

Gilt für: