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