Control.EnsureChildControls Método

protected:
 virtual void EnsureChildControls();

protected virtual void EnsureChildControls();

abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit

Protected Overridable Sub EnsureChildControls ()

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.

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

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.

• Controls
• ChildControlsCreated
• CreateChildControls()