Page.VerifyRenderingInServerForm(Control) Page.VerifyRenderingInServerForm(Control) Page.VerifyRenderingInServerForm(Control) Method

Definición

Confirma que un control HtmlForm se represente para el control de servidor ASP.NET especificado en tiempo de ejecución.Confirms that an HtmlForm control is rendered for the specified ASP.NET server control at run time.

public:
 virtual void VerifyRenderingInServerForm(System::Web::UI::Control ^ control);
public virtual void VerifyRenderingInServerForm (System.Web.UI.Control control);
abstract member VerifyRenderingInServerForm : System.Web.UI.Control -> unit
override this.VerifyRenderingInServerForm : System.Web.UI.Control -> unit

Parámetros

control
Control Control Control

Control de servidor ASP.NET que es necesario en el control HtmlForm.The ASP.NET server control that is required in the HtmlForm control.

Excepciones

El control de servidor especificado no está incluido entre las etiquetas de apertura y cierre del control de servidor HtmlForm en tiempo de ejecución.The specified server control is not contained between the opening and closing tags of the HtmlForm server control at run time.

El control que se va a comprobar es null.The control to verify is null.

Ejemplos

En el ejemplo de código siguiente se invalida Page.Render el método de un control de servidor personalizado.The following code example overrides the Page.Render method of a custom server control. Cuando este control escribe su contenido en una página, usa el VerifyRenderingInServerForm método para asegurarse de que el control aparece entre las etiquetas de apertura y cierre de un HtmlForm control.When this control writes its content to a page, it uses the VerifyRenderingInServerForm method to make sure that the control appears between the opening and closing tags of an HtmlForm control.

// Override the Render method to ensure that this control
// is nested in an HtmlForm server control, between a <form runat=server>
// opening tag and a </form> closing tag.
protected override void Render(HtmlTextWriter writer) {
    // Ensure that the control is nested in a server form.
    if (Page != null) {
        Page.VerifyRenderingInServerForm(this);
    }
    base.Render(writer);
}
' Override the Render method to ensure that this control
' is nested in an HtmlForm server control, between a <form runat=server>
' opening tag and a </form> closing tag.
Protected Overrides Sub Render(ByVal writer As HtmlTextWriter)

    ' Ensure that the control is nested in a server form.
    If Not (Page Is Nothing) Then
        Page.VerifyRenderingInServerForm(Me)
    End If

    MyBase.Render(writer)

End Sub

Comentarios

Los controles que deben estar dentro <form runat=server> de las etiquetas pueden llamar a este método antes de que se representen para que se muestre un mensaje de error si se colocan fuera de las etiquetas.Controls that are required to be inside <form runat=server> tags can call this method before they render so that an error message is shown if they are placed outside the tags. Los controles que devuelven o dependen de bloques de script registrados deben llamar a este método en Control.Render una invalidación del método.Controls that post back or depend on registered script blocks should call this method in an override of the Control.Render method. Las páginas que tienen una manera diferente de representar el elemento de formulario de servidor pueden invalidar este método para producir una excepción en condiciones diferentes.Pages that have a different way of rendering the server form element can override this method to throw an exception under different conditions.

Los controles de servidor que devuelven o usan scripts del lado cliente no funcionarán si no se HtmlForm incluyen en las etiquetasform runat="server">de control de servidor (<).Server controls that post back or use client-side script will not work if they are not enclosed in the HtmlForm server control (<form runat="server">) tags. Estos controles pueden llamar a este método cuando se representan para proporcionar un mensaje de error claro cuando no se incluyen en HtmlForm el control.These controls can call this method when they render to provide a clear error message when they are not enclosed in the HtmlForm control.

Al desarrollar un control de servidor personalizado, es habitual llamar a este método cuando se invalida el Render método para cualquier tipo de etiqueta de entrada.When you develop a custom server control, it is common to call this method when you override the Render method for any kind of input tag. Esto es especialmente importante si el control de entrada GetPostBackEventReferencellama a o si emite el script de cliente.This is particularly important if the input control calls GetPostBackEventReference, or if it emits client script. No es necesario que un control de servidor compuesto realice esta llamada.A composite server control does not need to make this call.

Se aplica a