Dieser Artikel wurde maschinell übersetzt. Wenn Sie die englische Version des Artikels anzeigen möchten, aktivieren Sie das Kontrollkästchen Englisch. Sie können den englischen Text auch in einem Popupfenster anzeigen, indem Sie den Mauszeiger über den Text bewegen.
Übersetzung
Englisch

Page.VerifyRenderingInServerForm-Methode: (Control)

 

Veröffentlicht: Oktober 2016

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)

public virtual void VerifyRenderingInServerForm(
	Control control
)

Parameter

control
Type: System.Web.UI.Control

Das ASP.NET-Serversteuerelement, die erforderlich ist, in der HtmlForm Steuerelement.

Exception Condition
HttpException

Das angegebene Steuerelement ist nicht zwischen dem öffnenden und schließenden Tags des enthalten die HtmlForm -Steuerelement zur Laufzeit.

ArgumentNullException

Das zu überprüfende Steuerelement ist null.

Steuerelemente, die erforderlich sind, werden in <form runat=server> Tags können diese Methode aufrufen, vor dem Rendern, damit eine Fehlermeldung angezeigt wird, wenn sie außerhalb der Tags eingefügt werden. Steuerelemente, die registrierte Skriptblöcke abhängig sind oder zurücksenden, sollten diese Methode aufrufen, in einer Überschreibung der Control.Render Methode. Seiten mit anders rendern das Serverformularelement können diese Methode zum Auslösen einer Ausnahme in verschiedenen Situationen überschreiben.

Serversteuerelemente, die Postback oder Clientskripts verwenden, funktionieren nicht, wenn sie nicht, in eingeschlossen sind der HtmlForm -Steuerelement (<form runat="server">) Tags. Diese Steuerelemente können diese Methode aufrufen, beim Rendern auf eine Meldung zur Fehlerbeseitigung bereitzustellen, wenn sie nicht, in eingeschlossen sind der HtmlForm Steuerelement.

Wenn Sie ein benutzerdefiniertes Steuerelement entwickeln, es ist üblich, diese Methode aufrufen, wenn Sie überschreiben die Render Methode für jede Art von input-Tag. Dies ist besonders wichtig, wenn das Eingabesteuerelement aufruft GetPostBackEventReference, oder Clientskript ausgibt. Ein zusammengesetztes Serversteuerelement muss nicht zum Ausführen dieses Aufrufs.

Im folgenden Codebeispiel Beispiel überschreibt die Page.Render -Methode eines benutzerdefinierten Steuerelements. Wenn dieses Steuerelement seinen Inhalt in eine Seite schreibt, verwendet es die VerifyRenderingInServerForm Methode, um sicherzustellen, dass das Steuerelement zwischen dem öffnenden und schließenden Tags des wird ein HtmlForm Steuerelement.

// 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);
}

.NET Framework
Verfügbar seit 1.1
Zurück zum Anfang
Anzeigen: