Control.EnsureChildControls Control.EnsureChildControls Control.EnsureChildControls Control.EnsureChildControls Method

Definición

Determina si el control de servidor contiene controles secundarios.Determines whether the server control contains child controls. Si no tiene controles secundarios, los crea.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 ()

Ejemplos

En el ejemplo siguiente se EnsureChildControls usa el método para asegurarse de que el control de servidor actual tiene controles secundarios.The following example uses the EnsureChildControls method to ensure that the current server control has child controls. A continuación, obtiene o establece Text una propiedad para un TextBox control Web secundario en el objeto del control ControlCollection de servidor actual.It then gets or sets a Text property for a child TextBox Web control in the current server control's ControlCollection object.

Importante

Este ejemplo tiene un cuadro de texto que acepta datos proporcionados por el usuario, lo que puede suponer una amenaza para la seguridad.This example has a text box that accepts user input, which is a potential security threat. De forma predeterminada, ASP.NET Web Pages valida que los datos proporcionados por el usuario no incluyen elementos HTML ni de script.By default, ASP.NET Web pages validate that user input does not include script or HTML elements. Para más información, consulte Información general sobre los ataques mediante scripts.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


Comentarios

Este método comprueba primero el valor actual de la ChildControlsCreated propiedad.This method first checks the current value of the ChildControlsCreated property. Si este valor es false, se CreateChildControls llama al método.If this value is false, the CreateChildControls method is called.

El EnsureChildControls método se utiliza normalmente en controles compuestos, que son controles que usan controles secundarios para alguna funcionalidad o para toda su funcionalidad.The EnsureChildControls method is typically used in composite controls, which are controls that use child controls for some or all their functionality. Se EnsureChildControls llama al método para asegurarse de que los controles secundarios se han creado y están listos para procesar la entrada, para realizar el enlace de datos o para realizar otras tareas.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.

El GridView control es un ejemplo de un control compuesto.The GridView control is an example of a composite control. Crea controles Tablesecundarios como TableRow TableCell GridView los controles,,, y TextBox , que se usan para representar la tabla HTML que genera. LabelIt creates child controls such as Table, TableRow, TableCell, Label, and TextBox controls, which are used to render the HTML table that the GridView generates.

En la mayoría de los casos, los desarrolladores de controles de servidor personalizados no tienen que invalidar este método.In most cases, custom server control developers do not have to override this method. Si invalida este método, úselo de forma similar al comportamiento predeterminado.If you do override this method, use it in a way similar to the default behavior.

Se aplica a

Consulte también: