Page.VerifyRenderingInServerForm(Control) Methode

Definitie

Naamruimte:
System.Web.UI
Assembly:
System.Web.dll

Bevestigt dat een besturingselement HtmlForm wordt weergegeven voor het opgegeven ASP.NET serverbeheer tijdens runtime.

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
Public Overridable Sub VerifyRenderingInServerForm (control As Control)

Parameters

control
Control

Het ASP.NET serverbeheer dat vereist is in het besturingselement HtmlForm.

Uitzonderingen

HttpException

Het opgegeven serverbeheer bevindt zich niet tussen de openings- en afsluittags van het HtmlForm serverbeheer tijdens runtime.

ArgumentNullException

Het besturingselement dat moet worden gecontroleerd, is null.

Voorbeelden

In het volgende codevoorbeeld wordt de Page.Render methode van een aangepast serverbeheer overschreven. Wanneer dit besturingselement de inhoud naar een pagina schrijft, wordt de VerifyRenderingInServerForm methode gebruikt om ervoor te zorgen dat het besturingselement wordt weergegeven tussen de openings- en sluitingstags van een HtmlForm besturingselement.

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

Opmerkingen

Besturingselementen die in tags moeten staan <form runat=server> , kunnen deze methode aanroepen voordat ze worden weergegeven, zodat er een foutbericht wordt weergegeven als ze buiten de tags worden geplaatst. Besturingselementen die terugzetten of afhankelijk zijn van geregistreerde scriptblokken, moeten deze methode aanroepen in een onderdrukking van de Control.Render methode. Pagina's met een andere manier om het formulierelement van de server weer te geven, kunnen deze methode overschrijven om een uitzondering onder verschillende omstandigheden te genereren.

Serverbesturingselementen die een bericht plaatsen of het script aan de clientzijde gebruiken, werken niet als ze niet zijn ingesloten in de HtmlForm serverbesturingselementtags (<form runat="server">). Deze besturingselementen kunnen deze methode aanroepen wanneer ze worden weergegeven om een duidelijk foutbericht te geven wanneer ze niet in het HtmlForm besturingselement zijn opgenomen.

Wanneer u een aangepast serverbeheer ontwikkelt, is het gebruikelijk deze methode aan te roepen wanneer u de Render methode overschrijft voor elk type invoertag. Dit is met name belangrijk als het invoerbeheer aanroept GetPostBackEventReferenceof als het clientscript verzendt. Een samengesteld serverbesturingselement hoeft deze aanroep niet te doen.

Van toepassing op