Control.EnsureChildControls Metoda

Definice

Určuje, zda ovládací prvek serveru obsahuje podřízené ovládací prvky.Determines whether the server control contains child controls. Pokud tomu tak není, vytvoří podřízené ovládací prvky.If it does not, it creates child controls.

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á EnsureChildControls metodu pro zajištění, že aktuální serverový ovládací prvek má podřízené ovládací prvky.The following example uses the EnsureChildControls method to ensure that the current server control has child controls. Poté Získá nebo nastaví Text vlastnost podřízeného TextBox webového ovládacího prvku v objektu aktuálního ovládacího prvku serveru ControlCollection .It then gets or sets a Text property for a child TextBox Web control in the current server control's ControlCollection object.

Důležité

V tomto příkladu je textové pole, které přijímá vstup uživatele, což je potenciální bezpečnostní hrozba.This example has a text box that accepts user input, which is a potential security threat. Ve výchozím nastavení webové stránky ASP.NET ověřují, zda vstup uživatele nezahrnuje skripty ani prvky jazyka HTML.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Další informace najdete v tématu Přehled zneužití skriptů.For more information, see Script Exploits Overview.

// 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 kontroluje aktuální hodnotu ChildControlsCreated Vlastnosti.This method first checks the current value of the ChildControlsCreated property. Pokud je tato hodnota false , CreateChildControls je volána metoda.If this value is false, the CreateChildControls method is called.

EnsureChildControlsMetoda 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.The EnsureChildControls method is typically used in composite controls, which are controls that use child controls for some or all their functionality. EnsureChildControlsMetoda je volána, aby bylo zajištěno, že byly vytvořeny podřízené ovládací prvky a jsou připraveny ke zpracování vstupu, k provádění datových vazeb nebo k provádění jiných úloh.The EnsureChildControls method is called in order to make sure that child controls have been created and are ready to process input, to perform data binding, or to perform other tasks.

GridViewOvládací prvek je příkladem složeného ovládacího prvku.The GridView control is an example of a composite control. Vytvoří podřízené ovládací prvky, jako například,,, Table TableRow TableCell Label a TextBox ovládací prvky, které jsou použity k vykreslení tabulky HTML, kterou GridView generuje.It creates child controls such as Table, TableRow, TableCell, Label, and TextBox controls, which are used to render the HTML table that the GridView generates.

Ve většině případů nemusí vlastní vývojáři na serverový ovládací prvek přepisovat tuto metodu.In most cases, custom server control developers do not have to override this method. Pokud přepíšete tuto metodu, použijte ji podobným způsobem jako výchozí chování.If you do override this method, use it in a way similar to the default behavior.

Platí pro

Viz také