Control.EnsureChildControls Метод

Определение

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

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 TableCell , Label и TextBox , которые используются для визуализации таблицы HTML, GridView создаваемой.

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

Применяется к

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