Поделиться через

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

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

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

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