Page.VerifyRenderingInServerForm(Control) Metoda

Reference

Definice

Obor názvů:: System.Web.UI

Sestavení:: System.Web.dll

Důležité

Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.

Potvrdí, že HtmlForm se ovládací prvek vykresluje pro zadaný ovládací prvek serveru ASP.NET za běhu.

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)

Parametry

control: Control

Ovládací prvek serveru ASP.NET, který je v ovládacím HtmlForm prvku povinný.

Výjimky

HttpException

Zadaný ovládací prvek serveru není obsažen mezi levou a pravou značkou HtmlForm ovládacího prvku serveru za běhu.

ArgumentNullException

Ovládací prvek k ověření je null.

Příklady

Následující příklad kódu přepíše Page.Render metodu vlastního ovládacího prvku serveru. Když tento ovládací prvek zapíše obsah na stránku, použije VerifyRenderingInServerForm metodu k zajištění, aby se ovládací prvek zobrazil mezi levou a pravou značkou HtmlForm ovládacího prvku.

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

Poznámky

Ovládací prvky, které musí být uvnitř <form runat=server> značek, mohou tuto metodu volat předtím, než se vykreslují, aby se zobrazila chybová zpráva, pokud jsou umístěny mimo značky. Ovládací prvky, které posílají zpět nebo závisí na blokech registrovaných skriptů, by měly tuto metodu Control.Render volat v přepsání metody. Stránky, které mají jiný způsob vykreslování elementu formuláře serveru, mohou tuto metodu přepsat tak, aby vyvolaly výjimku za různých podmínek.

Serverové ovládací prvky, které publikují zpět nebo používají skript na straně klienta, nebudou HtmlForm fungovat, pokud nejsou uzavřeny do značek ovládacího prvku serveru (<form runat="server">). Tyto ovládací prvky můžou tuto metodu volat, když vykreslují, aby poskytovaly jasnou chybovou HtmlForm zprávu, když nejsou uzavřeny do ovládacího prvku.

Při vývoji vlastního ovládacího prvku serveru je běžné volat tuto metodu Render při přepsání metody pro jakýkoli druh vstupní značky. To je obzvláště důležité, pokud vstupní ovládací volání GetPostBackEventReference, nebo pokud generuje klientský skript. Složený ovládací prvek serveru nemusí volat.

Platí pro

Sdílet prostřednictvím