Partilhar via


TemplateControl.LoadControl Método

Definição

Carrega um Control.

Sobrecargas

LoadControl(String)

Carrega um objeto Control de um arquivo com base no caminho virtual especificado.

LoadControl(Type, Object[])

Carrega um objeto Control baseado em um tipo especificado e nos parâmetros do construtor.

Comentários

Quando você carrega um controle em um controle de contêiner, o contêiner gera todos os eventos do controle adicionado até que ele tenha capturado o evento atual. No entanto, o controle adicionado não acompanha o processamento de dados de postback. Para que um controle adicionado participe do processamento de dados de postback, incluindo a validação, o controle deve ser adicionado no Init evento em vez de no Load evento .

LoadControl(String)

Carrega um objeto Control de um arquivo com base no caminho virtual especificado.

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

Parâmetros

virtualPath
String

O caminho virtual para um arquivo de controle.

Retornos

Retorna o Control especificado.

Exceções

O caminho virtual é null ou vazio.

Exemplos

O exemplo de código a seguir demonstra como usar o LoadControl método para adicionar um controle de usuário a uma página ASP.NET.

No método event OnInit , esta página usa o LoadControl método para criar programaticamente um controle de usuário na página. O método adiciona o controle à Controls propriedade de um PlaceHolder controle de servidor Web chamado Placeholder1.

Para obter a definição da MyControl classe usada neste exemplo de código, consulte 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

Comentários

Se o controle der suporte ao cache, o objeto retornado do LoadControl método não será, na verdade, um Control objeto ; em vez disso, ele é um PartialCachingControl objeto . Se o virtualPath parâmetro for relativo, o caminho do controle carregado será relativo ao caminho do TemplateControl.

Quando você carrega um controle em um controle de contêiner, o contêiner gera todos os eventos do controle adicionado até que ele tenha capturado o evento atual. No entanto, o controle adicionado não acompanha o processamento de dados de postback. Para que um controle adicionado participe do processamento de dados de postback, incluindo a validação, o controle deve ser adicionado no Init evento em vez de no Load evento .

Confira também

Aplica-se a

LoadControl(Type, Object[])

Carrega um objeto Control baseado em um tipo especificado e nos parâmetros do construtor.

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

Parâmetros

t
Type

O tipo do controle.

parameters
Object[]

Uma matriz de argumentos que correspondem em número, ordem e tipo aos parâmetros do construtor a ser invocado. Se parameters for uma matriz vazia ou null, o construtor que não usa nenhum parâmetro (o construtor sem parâmetros) será invocado.

Retornos

Retorna o UserControl especificado.

Comentários

Se o controle de usuário der suporte ao cache, o objeto retornado do LoadControl método não será realmente um UserControl objeto ; em vez disso, ele é um PartialCachingControl objeto .

Quando você carrega um controle em um controle de contêiner, o contêiner gera todos os eventos do controle adicionado até que ele tenha capturado o evento atual. No entanto, o controle adicionado não acompanha o processamento de dados de postback. Para que um controle adicionado participe do processamento de dados de postback, incluindo a validação, o controle deve ser adicionado no Init evento em vez de no Load evento .

Confira também

Aplica-se a