Control.EnsureChildControls Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Determinará se o controle de servidor contiver controles filho. Se ele não contiver, ele criará controles filho.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls ();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected Overridable Sub EnsureChildControls ()Exemplos
O exemplo a seguir usa o EnsureChildControls método para garantir que o controle de servidor atual tenha controles filho. Em seguida, ele obtém ou define uma Text propriedade para um controle Web filho TextBox no objeto do controle do ControlCollection servidor atual.
Importante
Este exemplo tem uma caixa de texto que aceita a entrada do usuário, que é uma possível ameaça à segurança. Por padrão, ASP.NET páginas da Web validam que a entrada do usuário não inclui elementos html ou script. Para obter mais informações, consulte Visão geral de explorações de script.
// 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
Comentários
Esse método primeiro verifica o valor atual da ChildControlsCreated propriedade. Se esse valor for false, o CreateChildControls método será chamado.
O EnsureChildControls método normalmente é usado em controles compostos, que são controles que usam controles filho para algumas ou todas as suas funcionalidades. O EnsureChildControls método é chamado para garantir que os controles filho tenham sido criados e estejam prontos para processar a entrada, executar a associação de dados ou executar outras tarefas.
O GridView controle é um exemplo de um controle composto. Ele cria controles filho, como Table, TableCellTableRow, Label, eTextBox, que são usados para renderizar a tabela HTML gerada GridView pelo .
Na maioria dos casos, os desenvolvedores de controle de servidor personalizado não precisam substituir esse método. Se você substituir esse método, use-o de maneira semelhante ao comportamento padrão.
