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 usa el EnsureChildControls 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 un Text propiedad para un elemento secundario TextBox control en el control de servidor actual Web ControlCollection objeto.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, el CreateChildControls se llama al método.If this value is false, the CreateChildControls method is called.

El EnsureChildControls método suele usarse en los controles compuestos, que son controles que usan los controles secundarios para algunas o todas sus funciones.The EnsureChildControls method is typically used in composite controls, which are controls that use child controls for some or all their functionality. El EnsureChildControls se llama al método con el fin de asegurarse de que los controles secundarios se han creado y están listos para procesar la entrada, para realizar el enlace de datos o 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 secundarios como Table, TableRow, TableCell, Label, y TextBox controles, que se utilizan para representar el código HTML de la tabla que la GridView genera.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.

En la mayoría de los casos, los desarrolladores de controles de servidor personalizado no es necesario invalidar este método.In most cases, custom server control developers do not have to override this method. Si invalida este método, usarlo 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: