TemplateControl.LoadControl Metódus

Definíció

Névtér:
System.Web.UI
Szerelvény:
System.Web.dll

Betölt egy Control.

Túlterhelések

Name Description
LoadControl(String)

Betölt egy Control objektumot egy fájlból egy megadott virtuális elérési út alapján.
LoadControl(Type, Object[])

Betölt egy objektumot Control egy megadott típus és konstruktorparaméter alapján.

Megjegyzések

Amikor betölt egy vezérlőt egy tárolóvezérlőbe, a tároló a hozzáadott vezérlő összes eseményét addig emeli, amíg el nem éri az aktuális eseményt. A hozzáadott vezérlő azonban nem utoléri a visszaküldött adatok feldolgozását. Ahhoz, hogy egy vezérlő részt vegyen a visszavétel utáni adatfeldolgozásban, beleértve az ellenőrzést is, a vezérlőt nem az eseményben, hanem az InitLoad eseményben kell hozzáadni.

LoadControl(String)

Betölt egy Control objektumot egy fájlból egy megadott virtuális elérési út alapján.

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

Paraméterek

virtualPath
String

A vezérlőfájl virtuális elérési útja.

Válaszok

Control

A megadott Controlértéket adja vissza.

Kivételek

ArgumentNullException

A virtuális elérési út üres null vagy üres.

Példák

Az alábbi példakód bemutatja, hogyan használható a LoadControl metódus egy felhasználói vezérlő hozzáadására egy ASP.NET lapra.

Az eseménymetódusban ez a OnInit lap a LoadControl metódus használatával programozott módon hoz létre felhasználói vezérlőt a lapon. A metódus hozzáadja a vezérlőt egy ControlsPlaceHolder nevű webkiszolgáló-vezérlő Placeholder1tulajdonságához.

Az ebben a MyControl kód példában használt osztály definícióját lásd 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

Megjegyzések

Ha a vezérlő támogatja a gyorsítótárazást, a metódusból LoadControl visszaadott objektum valójában Control nem objektum, hanem objektum PartialCachingControl . Ha a virtualPath paraméter relatív, a betöltött vezérlő elérési útja a TemplateControl.

Amikor betölt egy vezérlőt egy tárolóvezérlőbe, a tároló a hozzáadott vezérlő összes eseményét addig emeli, amíg el nem éri az aktuális eseményt. A hozzáadott vezérlő azonban nem utoléri a visszaküldött adatok feldolgozását. Ahhoz, hogy egy vezérlő részt vegyen a visszavétel utáni adatfeldolgozásban, beleértve az ellenőrzést is, a vezérlőt nem az eseményben, hanem az InitLoad eseményben kell hozzáadni.

Lásd még

A következőre érvényes:

LoadControl(Type, Object[])

Betölt egy objektumot Control egy megadott típus és konstruktorparaméter alapján.

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

Paraméterek

t
Type

A vezérlő típusa.

parameters
Object[]

Argumentumok tömbje, amelyek számban, sorrendben és a meghívandó konstruktor paramétereinek beírásával egyeznek. Ha parameters üres tömb, vagy nullha a konstruktor nem használ paramétereket (a paraméter nélküli konstruktort) meghívja.

Válaszok

Control

A megadott UserControlértéket adja vissza.

Megjegyzések

Ha a felhasználói vezérlő támogatja a gyorsítótárazást, a metódusból LoadControl visszaadott objektum valójában UserControl nem objektum, hanem objektum PartialCachingControl .

Amikor betölt egy vezérlőt egy tárolóvezérlőbe, a tároló a hozzáadott vezérlő összes eseményét addig emeli, amíg el nem éri az aktuális eseményt. A hozzáadott vezérlő azonban nem utoléri a visszaküldött adatok feldolgozását. Ahhoz, hogy egy vezérlő részt vegyen a visszavétel utáni adatfeldolgozásban, beleértve az ellenőrzést is, a vezérlőt nem az eseményben, hanem az InitLoad eseményben kell hozzáadni.

Lásd még

A következőre érvényes: