Control.EnsureChildControls Метод

Определение

Пространство имен:

System.Web.UI

Сборка:

System.Web.dll

Определяет наличие у серверного элемента управления дочерних элементов управления. Если дочерних элементов управления нет, они будут созданы.

protected:
 virtual void EnsureChildControls();

protected virtual void EnsureChildControls ();

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

Protected Overridable Sub EnsureChildControls ()

Примеры

В следующем примере используется EnsureChildControls метод, чтобы убедиться, что текущий серверный элемент управления содержит дочерние элементы управления. Затем он получает или задает Text свойство дочернего TextBox веб-элемента управления в объекте текущего серверного ControlCollection элемента управления.

Важно!

В этом примере имеется текстовое поле, принимающее вводимые пользователем данные, что является потенциальной угрозой безопасности. По умолчанию данные, вводимые пользователем на веб-страницах ASP.NET, проверяются на наличие скриптов и HTML-элементов. Дополнительные сведения см. в разделе Общие сведения об использовании сценариев.

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

Комментарии

Этот метод сначала проверяет текущее значение ChildControlsCreated свойства. Если это значение равно false, CreateChildControls вызывается метод.

Этот EnsureChildControls метод обычно используется в составных элементах управления, которые используют дочерние элементы управления для некоторых или всех их функциональных возможностей. Метод EnsureChildControls вызывается, чтобы убедиться, что дочерние элементы управления созданы и готовы обрабатывать входные данные, выполнять привязку данных или выполнять другие задачи.

Элемент GridView управления является примером составного элемента управления. Он создает дочерние элементы управления, такие как Table, TableRow, LabelTableCellи TextBox элементы управления, которые используются для отрисовки html-таблицы, которая GridView создает.

В большинстве случаев разработчикам пользовательских серверных элементов управления не нужно переопределять этот метод. Если вы переопределите этот метод, используйте его таким образом, как поведение по умолчанию.

См. также раздел

• Controls
• ChildControlsCreated
• CreateChildControls()