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 serverový ovládací prvek 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 -> unitProtected Overridable Sub EnsureChildControls ()Příklady
Následující příklad používá metodu EnsureChildControls k zajištění, že aktuální serverový ovládací prvek 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 aktuálního serverového ControlCollection ovládacího prvku.
Důležité
Tento příklad obsahuje 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ěřte, že uživatelský vstup neobsahuje skript nebo 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 falsetato hodnota , CreateChildControls je volána metoda .
Metoda se EnsureChildControls obvykle používá ve složených ovládacích prvcích, což jsou ovládací prvky, které pro některé nebo všechny funkce používají podřízené ovládací prvky. Metoda EnsureChildControls je volána, aby se zajistilo, že byly vytvořeny podřízené ovládací prvky a jsou připravené ke zpracování vstupu, k provedení datové vazby nebo k 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 Tablejsou , TableCellTableRow, , Labela, které TextBox slouží k vykreslení tabulky HTML, kterou generujeGridView.
Ve většině případů vývojáři vlastních serverových ovládacích prvků nemusí tuto metodu přepsat. Pokud tuto metodu přepíšete, použijte ji podobným způsobem jako výchozí chování.
