Control.EnsureChildControls Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет, содержит ли серверный элемент управления дочерние элементы управления. Если это не так, он создает дочерние элементы управления.
protected:
virtual void EnsureChildControls();protected virtual void EnsureChildControls();abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unitProtected 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, TableRowTableCell, Labelи TextBox элементы управления, которые используются для отрисовки HTML-таблицы, которая GridView создает.
В большинстве случаев разработчикам пользовательского управления сервера не нужно переопределять этот метод. При переопределении этого метода используйте его таким образом, как поведение по умолчанию.
