Control.EnsureChildControls Metoda

Definice

Obor názvů:

System.Web.UI

Sestavení:

System.Web.dll

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 -> unit

Protected 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í.

Viz také

• Controls
• ChildControlsCreated
• CreateChildControls()