Partilhar via

TemplateControl.LoadControl Método

Definição

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

Carrega um Control.

Sobrecargas

Nome Description
LoadControl(String)

Carrega um Control objeto de um arquivo com base em um caminho virtual especificado.
LoadControl(Type, Object[])

Carrega um Control objeto com base em um tipo e parâmetros de construtor especificados.

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 pego 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 e não no Load evento.

LoadControl(String)

Carrega um Control objeto de um arquivo com base em um 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

Control

Retorna o especificado Control.

Exceções

ArgumentNullException

O caminho virtual está ou está null 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 de OnInit evento, 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 é realmente um Control objeto; em vez disso, é 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 pego 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 e não no Load evento.

Confira também

Aplica-se a

LoadControl(Type, Object[])

Carrega um Control objeto com base em um tipo e parâmetros de construtor especificados.

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 digite os parâmetros do construtor a ser invocado. Se parameters for uma matriz vazia ou null, o construtor que não usa parâmetros (o construtor sem parâmetros) será invocado.

Retornos

Control

Retorna o especificado UserControl.

Comentários

Se o controle de usuário der suporte ao cache, o objeto retornado do LoadControl método não é realmente um UserControl objeto; em vez disso, é 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 pego 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 e não no Load evento.

Confira também

Aplica-se a