Condividi tramite


TemplateControl.LoadControl Metodo

Definizione

Carica un oggetto Control.

Overload

LoadControl(String)

Carica un controllo Control da un file in base al percorso virtuale specificato.

LoadControl(Type, Object[])

Carica un oggetto Control in base al tipo e ai parametri del costruttore specificati.

Commenti

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunti fino a quando non viene rilevata fino all'evento corrente. Tuttavia, il controllo aggiunto non rileva l'elaborazione dei dati postback. Per un controllo aggiunto per partecipare all'elaborazione dei dati postback, inclusa la convalida, è necessario aggiungere il controllo nell'evento anziché nell'evento InitLoad .

LoadControl(String)

Carica un controllo Control da un file in base al percorso virtuale specificato.

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

Parametri

virtualPath
String

Percorso virtuale di un file di controllo.

Restituisce

Restituisce l'oggetto Control specificato.

Eccezioni

Il percorso virtuale è null o vuoto.

Esempio

Nell'esempio di codice seguente viene illustrato come usare il LoadControl metodo per aggiungere un controllo utente a una pagina ASP.NET.

OnInit Nel metodo evento questa pagina usa il LoadControl metodo per creare a livello di codice un controllo utente nella pagina. Il metodo aggiunge il controllo alla Controls proprietà di un PlaceHolder controllo server Web denominato Placeholder1.

Per la definizione della MyControl classe usata in questo esempio di codice, vedere 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

Commenti

Se il controllo supporta la memorizzazione nella cache, l'oggetto restituito dal LoadControl metodo non è effettivamente un oggetto; invece, è un ControlPartialCachingControl oggetto. Se il parametro è relativo, il virtualPath percorso del controllo caricato è relativo al percorso dell'oggetto TemplateControl.

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunti fino a quando non viene rilevata fino all'evento corrente. Tuttavia, il controllo aggiunto non rileva l'elaborazione dei dati postback. Per un controllo aggiunto per partecipare all'elaborazione dei dati postback, inclusa la convalida, è necessario aggiungere il controllo nell'evento anziché nell'evento InitLoad .

Vedi anche

Si applica a

LoadControl(Type, Object[])

Carica un oggetto Control in base al tipo e ai parametri del costruttore specificati.

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

Parametri

t
Type

Tipo del controllo.

parameters
Object[]

Una matrice di argomenti che corrispondono per numero, ordine e tipo ai parametri del costruttore da richiamare. Se parameters è una matrice vuota oppure null, viene chiamato il costruttore che non accetta parametri, ovvero il costruttore senza parametri.

Restituisce

Restituisce l'oggetto UserControl specificato.

Commenti

Se il controllo utente supporta la memorizzazione nella cache, l'oggetto restituito dal LoadControl metodo non è effettivamente un oggetto; invece, è un UserControlPartialCachingControl oggetto.

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunti fino a quando non viene rilevata fino all'evento corrente. Tuttavia, il controllo aggiunto non rileva l'elaborazione dei dati postback. Per un controllo aggiunto per partecipare all'elaborazione dei dati postback, inclusa la convalida, è necessario aggiungere il controllo nell'evento anziché nell'evento InitLoad .

Vedi anche

Si applica a