Condividi tramite

TemplateControl.LoadControl Metodo

Definizione

Spazio dei nomi:
System.Web.UI
Assembly:
System.Web.dll

Carica un oggetto Control.

Overload

Nome Descrizione
LoadControl(String)

Carica un Control oggetto da un file in base a un percorso virtuale specificato.
LoadControl(Type, Object[])

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

Commenti

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunto fino a quando non viene raggiunto l'evento corrente. Tuttavia, il controllo aggiunto non viene aggiornato con l'elaborazione dei dati di postback. Affinché un controllo aggiunto partecipi all'elaborazione dei dati di postback, inclusa la convalida, il controllo deve essere aggiunto nell'evento Init anziché nell'evento Load .

LoadControl(String)

Carica un Control oggetto da un file in base a un 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

Control

Restituisce l'oggetto specificato Control.

Eccezioni

ArgumentNullException

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.

Nel metodo dell'evento OnInit 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 Control oggetto, ma è un PartialCachingControl oggetto . Se il virtualPath parametro è relativo, il percorso del controllo caricato è relativo al percorso di TemplateControl.

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunto fino a quando non viene raggiunto l'evento corrente. Tuttavia, il controllo aggiunto non viene aggiornato con l'elaborazione dei dati di postback. Affinché un controllo aggiunto partecipi all'elaborazione dei dati di postback, inclusa la convalida, il controllo deve essere aggiunto nell'evento Init anziché nell'evento Load .

Vedi anche

Si applica a

LoadControl(Type, Object[])

Carica un Control oggetto in base a un tipo e a 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[]

Matrice di argomenti che corrispondono in numero, ordine e digitare i parametri del costruttore da richiamare. Se parameters è una matrice vuota o null, viene richiamato il costruttore che non accetta parametri (il costruttore senza parametri).

Restituisce

Control

Restituisce l'oggetto specificato UserControl.

Commenti

Se il controllo utente supporta la memorizzazione nella cache, l'oggetto restituito dal LoadControl metodo non è effettivamente un UserControl oggetto, ma è un PartialCachingControl oggetto .

Quando si carica un controllo in un controllo contenitore, il contenitore genera tutti gli eventi del controllo aggiunto fino a quando non viene raggiunto l'evento corrente. Tuttavia, il controllo aggiunto non viene aggiornato con l'elaborazione dei dati di postback. Affinché un controllo aggiunto partecipi all'elaborazione dei dati di postback, inclusa la convalida, il controllo deve essere aggiunto nell'evento Init anziché nell'evento Load .

Vedi anche

Si applica a