Control.EnsureChildControls Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Determina se o controlo do servidor contém controlos filhos. Se não o fizer, cria controlos filhos.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Exemplos
O exemplo seguinte utiliza o EnsureChildControls método para garantir que o controlo atual do servidor tem controlos filhos. Depois, recebe ou define uma Text propriedade para um controlo Web filho TextBox no objeto do ControlCollection controlo do servidor atual.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do utilizador, o que constitui uma potencial ameaça à segurança. Por defeito, as páginas Web do ASP.NET validam que a entrada do utilizador não inclui elementos de script ou HTML. Para mais informações, consulte Visão Geral dos Exploits de Scripts.
// Ensure the current control has children,
// then get or set the Text property.
public int Value {
get {
this.EnsureChildControls();
return Int32.Parse(((TextBox)Controls[1]).Text);
}
set {
this.EnsureChildControls();
((TextBox)Controls[1]).Text = value.ToString();
}
}
' Ensure the current control has children,
' then get or set the Text property.
Public Property Value() As Integer
Get
Me.EnsureChildControls()
Return Int32.Parse(CType(Controls(1), TextBox).Text)
End Get
Set
Me.EnsureChildControls()
CType(Controls(1), TextBox).Text = value.ToString()
End Set
End Property
Observações
Este método verifica primeiro o valor atual da ChildControlsCreated propriedade. Se este valor for false, o CreateChildControls método é chamado.
O EnsureChildControls método é tipicamente usado em controlos compostos, que são controlos que utilizam controlos filhos para parte ou toda a sua funcionalidade. O EnsureChildControls método é chamado para garantir que os controlos filhos foram criados e estão prontos para processar entradas, realizar ligação de dados ou realizar outras tarefas.
O GridView controlo é um exemplo de controlo composto. Cria controlos filhos como Table, TableRow, TableCell, Label, e TextBox controlos, que são usados para renderizar a tabela HTML que gera GridView .
Na maioria dos casos, os programadores de controlo de servidores personalizados não têm de sobrescrever este método. Se conseguires sobrepor este método, usa-o de forma semelhante ao comportamento padrão.
