Page.VerifyRenderingInServerForm-Methode

Bestätigt, dass ein HtmlForm-Steuerelement für das angegebene ASP.NET-Serversteuerelement zur Laufzeit gerendert wird.

Namespace: System.Web.UI
Assembly: System.Web (in system.web.dll)

Syntax

'Declaration
Public Overridable Sub VerifyRenderingInServerForm ( _
    control As Control _
)
'Usage
Dim instance As Page
Dim control As Control

instance.VerifyRenderingInServerForm(control)

public virtual void VerifyRenderingInServerForm (
    Control control
)

public:
virtual void VerifyRenderingInServerForm (
    Control^ control
)

public void VerifyRenderingInServerForm (
    Control control
)

public function VerifyRenderingInServerForm (
    control : Control
)

Parameter

• control
  Das ASP.NET-Serversteuerelement, das im HtmlForm-Steuerelement erforderlich ist.

Ausnahmen

Hinweise

Steuerelemente, die in <form runat=server>-Tags eingeschlossen sein müssen, können vor dem Rendern diese Methode aufrufen, sodass eine Fehlermeldung angezeigt wird, wenn sie außerhalb der Tags eingefügt werden. Steuerelemente, die registrierte Skriptblöcke zurücksenden oder von diesen abhängen, müssen diese Methode beim Überschreiben der Control.Render-Methode aufrufen. Seiten, die das Serverformularelement auf andere Weise rendern, können diese Methode überschreiben, um unter anderen Bedingungen eine Ausnahme auszulösen.

Serversteuerelemente, die Postback oder Clientskripts verwenden, werden nicht ausgeführt, wenn sie nicht in HtmlForm-Serversteuerelementtags (<form runat="server">) eingeschlossen sind. Diese Steuerelemente können diese Methode beim Rendern aufrufen, um eine Meldung zur Fehlerbeseitigung bereitzustellen, wenn sie nicht im HtmlForm-Steuerelement eingeschlossen sind.

Beim Entwickeln eines benutzerdefinierten Serversteuerelements wird diese Methode i. d. R. aufgerufen, wenn die Render-Methode für beliebige Eingabetags überschrieben wird. Dies ist besonders wichtig, wenn das Eingabesteuerelement GetPostBackEventReference aufruft oder Clientskript ausgibt. Ein zusammengesetztes Serversteuerelement muss diesen Aufruf nicht durchführen.

Beispiel

Im folgenden Codebeispiel wird die Page.Render-Methode eines benutzerdefinierten Serversteuerelements überschrieben. Wenn dieses Steuerelement seinen Inhalt in eine Seite schreibt, verwendet es die VerifyRenderingInServerForm-Methode, um sicherzustellen, dass sich das Steuerelement zwischen dem Start- und Endtag eines HtmlForm-Steuerelements befindet.

' 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

// 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 void Render(HtmlTextWriter writer)
{
    // Ensure that the control is nested in a server form.
    if (get_Page() != null) {
        get_Page().VerifyRenderingInServerForm(this);
    }
    super.Render(writer);
} //Render

Plattformen

Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Page-Klasse
Page-Member
System.Web.UI-Namespace