Control.EnsureChildControls Método

Definição

Namespace:

System.Web.UI

Assembly:

System.Web.dll

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 -> unit

Protected Overridable Sub EnsureChildControls ()

Exemplos

O exemplo a seguir usa o EnsureChildControls método para garantir que o controle do 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 ameaça à segurança em potencial. 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 verifica primeiro 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, comoTable, TableRow, e TableCellLabelTextBox controles, que são usados para renderizar a tabela HTML geradaGridView.

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 forma semelhante ao comportamento padrão.

Confira também

• Controls
• ChildControlsCreated
• CreateChildControls()