Control.EnsureChildControls Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky. Pokud ne, vytvoří podřízené ovládací prvky.
protected:
virtual void EnsureChildControls();
protected virtual void EnsureChildControls ();
abstract member EnsureChildControls : unit -> unit
override this.EnsureChildControls : unit -> unit
Protected Overridable Sub EnsureChildControls ()
Příklady
Následující příklad používá metodu EnsureChildControls k zajištění, že aktuální ovládací prvek serveru má podřízené ovládací prvky. Potom získá nebo nastaví Text vlastnost podřízeného webového TextBox ovládacího prvku v objektu ControlCollection aktuálního ovládacího prvku serveru.
Důležité
V tomto příkladu je textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba. Ve výchozím nastavení ASP.NET webové stránky ověřují, že vstup uživatele neobsahuje skripty ani elementy HTML. Další informace najdete v tématu Přehled zneužití skriptů.
// 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
Poznámky
Tato metoda nejprve zkontroluje aktuální hodnotu ChildControlsCreated vlastnosti. Pokud je false
tato hodnota, CreateChildControls volá se metoda.
Metoda EnsureChildControls se obvykle používá ve složených ovládacích prvcích, což jsou ovládací prvky, které používají podřízené ovládací prvky pro některé nebo všechny jejich funkce. Volá se EnsureChildControls metoda, aby se zajistilo, že byly vytvořeny podřízené ovládací prvky a jsou připravené ke zpracování vstupu, provádění datových vazeb nebo provádění jiných úloh.
Ovládací GridView prvek je příkladem složeného ovládacího prvku. Vytvoří podřízené ovládací prvky, jako Tableje , , TableRowLabelTableCell, a TextBox ovládací prvky, které se používají k vykreslení tabulky HTML, kterou GridView generuje.
Ve většině případů nemusí vývojáři vlastního řízení serveru tuto metodu přepsat. Pokud tuto metodu přepíšete, použijte ji podobným způsobem jako výchozí chování.