Exporter (0) Imprimer
Développer tout
Développer Réduire
Cet article a fait l'objet d'une traduction manuelle. Déplacez votre pointeur sur les phrases de l'article pour voir la version originale de ce texte.
Traduction
Source

Page.VerifyRenderingInServerForm, méthode

Confirme qu'un contrôle HtmlForm est rendu pour le contrôle serveur ASP.NET spécifié au moment de l'exécution.

Espace de noms :  System.Web.UI
Assembly :  System.Web (dans System.Web.dll)

public virtual void VerifyRenderingInServerForm(
	Control control
)

Paramètres

control
Type : System.Web.UI.Control
Contrôle serveur ASP.NET devant se trouver dans le contrôle HtmlForm.

ExceptionCondition
HttpException

Le contrôle serveur spécifié n'est pas contenu entre les balises d'ouverture et de fermeture du contrôle serveur HtmlForm au moment de l'exécution.

ArgumentNullException

Le contrôle à vérifier est null.

Les contrôles devant être à l'intérieur des balises <form runat=server> peuvent appeler cette méthode avant le rendu afin qu'un message d'erreur s'affiche s'ils ne sont pas entourés de balises. Les contrôles qui publient des blocs de script inscrits ou qui en dépendent devraient appeler cette méthode en substitution de la méthode Control.Render. Les pages ayant un mode de restitution différent de l'élément formulaire serveur peuvent substituer cette méthode pour lever une exception dans différentes conditions.

Les contrôles serveur qui publient ou utilisent un script côté client ne fonctionneront pas s'ils ne sont pas entourés des balises du contrôle serveur HtmlForm (<form runat="server">). Ces contrôles peuvent appeler cette méthode lors de leur restitution pour fournir un message d'erreur clair lorsqu'ils ne sont pas placés dans le contrôle HtmlForm.

Lorsque vous développez un contrôle serveur personnalisé, il est fréquent d'appeler cette méthode lorsque vous substituez la méthode Render pour tout type de balise d'entrée. Cela est particulièrement important si le contrôle d'entrée appelle GetPostBackEventReference ou s'il émet un script client. Un contrôle serveur composite n'a pas besoin d'effectuer cet appel.

L'exemple de code suivant substitue la méthode Page.Render d'un contrôle serveur personnalisé. Lorsque ce contrôle écrit son contenu à une page, il utilise la méthode VerifyRenderingInServerForm pour s'assurer que le contrôle apparaît entre les balises d'ouverture et de fermeture d'un contrôle HtmlForm.


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

Pris en charge dans : 4, 3.5, 3.0, 2.0, 1.1, 1.0

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Le .NET Framework ne prend pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

Ajouts de la communauté

AJOUTER
Microsoft réalise une enquête en ligne pour recueillir votre opinion sur le site Web de MSDN. Si vous choisissez d’y participer, cette enquête en ligne vous sera présentée lorsque vous quitterez le site Web de MSDN.

Si vous souhaitez y participer,
Afficher:
© 2014 Microsoft