Page, classe
Assembly : System.Web (dans system.web.dll)
La classe Page est associée aux fichiers ayant une extension .aspx. Ces fichiers sont compilés au moment de l'exécution en tant qu'objets Page et mis en cache dans la mémoire du serveur.
Si vous souhaitez créer une page Web Forms utilisant la même technique code-behind, dérivez de cette classe. Les concepteurs de développement rapide d'application (RAD, Rapid Application Development), tels que Visual Studio utilisent automatiquement ce modèle pour créer des pages Web Forms.
L'objet Page sert de conteneur de dénomination (naming container) pour tous les contrôles serveur dans une page, à l'exception de ceux qui implémentent l'interface INamingContainer ou qui sont des enfants des contrôles qui implémentent cette interface.
La classe Page est un contrôle qui agit en tant qu'interface utilisateur de votre application Web ; en tant que telle, vous devez l'examiner attentivement pour vous assurer que les méthodes conseillées pour l'écriture de code sécurisé et la sécurisation d'applications sont appliquées. Pour obtenir des informations générales sur ces rubriques, consultez Vue d'ensemble des menaces de sécurité des applications Web, Méthodes conseillées pour la stratégie de sécurité et Concepts fondamentaux sur la sécurité. Pour plus d'informations spécifiques, consultez Sécurisation de contrôles standard, Comment : afficher des messages d'erreur sécurisés, Comment : se protéger contre les attaques de script dans une application Web en utilisant le codage HTML et Introduction aux contrôles Validation.
| Rubrique | Emplacement |
|---|---|
| Comment : localiser les contrôles Web Forms sur une page en parcourant la collection Controls | Génération d'applications Web ASP.NET |
| Comment : déterminer la façon dont les pages Web ASP.NET ont été appelées | Génération d'applications Web ASP.NET |
| Procédure pas à pas : création de pages Web pour les périphériques mobiles | Génération d'applications Web ASP.NET dans Visual Studio |
| Comment : déterminer la façon dont les pages Web ASP.NET ont été appelées | Génération d'applications Web ASP.NET dans Visual Studio |
| Comment : localiser les contrôles Web Forms sur une page en parcourant la collection Controls | Génération d'applications Web ASP.NET dans Visual Studio |
L'exemple de code suivant montre comment la classe Page est utilisée dans le modèle de page code-behind. Notez que le fichier source code-behind déclare une classe partielle qui hérite d'une classe de page de base. La classe de page de base peut être Page, ou une autre classe qui dérive de Page. En outre, remarquez que la classe partielle permet au fichier code-behind d'utiliser des contrôles définis sur la page sans avoir besoin de les définir comme membres de champ.
using System; public partial class MyCodeBehindCS : System.Web.UI.Page { protected void Page_Load(object sender, EventArgs e) { // Place page-specific code here. } // Define a handler for the button click. protected void SubmitBtn_Click(object sender, EventArgs e) { MySpan.InnerHtml = "Hello, " + MyTextBox.Text + "."; } }
L'exemple de code suivant affiche le fichier .aspx qui correspond au fichier source code-behind précédent.
<%@ Page Language="C#" CodeFile="pageexample.aspx.cs" Inherits="MyCodeBehindCS" %> <html> <head runat="server"> <title>Page Class Example</title> </head> <body> <form runat="server"> <div> <table> <tr> <td> Name: </td> <td> <asp:textbox id="MyTextBox" runat="server"/> </td> </tr> <tr> <td></td> <td><asp:button id="MyButton" text="Click Here" onclick="SubmitBtn_Click" runat="server"/></td> </tr> <tr> <td></td> <td><span id="MySpan" runat="server" /></td> </tr> </table> </div> </form> </body> </html>
Vous devez utiliser la directive @ Page et utiliser les attributs Inherits et CodeFile pour lier le fichier code-behind au fichier .aspx. Dans cet exemple, l'attribut Inherits indique la classe MyCodeBehind et l'attribut CodeFile indique le chemin d'accès au fichier spécifique à la langue qui contient la classe.
L'exemple de code suivant montre le modèle de page à fichier unique et comment accéder à la propriété IsPostBack et la propriété Response du Page.
<%@ Page Language="C#" %> <script runat="server"> protected void Page_Load(object sender, EventArgs e) { StringBuilder sb = new StringBuilder(); if (Page.IsPostBack) sb.Append("You posted back to the page.<br>"); sb.Append("The host address is " + Page.Request.UserHostAddress + ".<br>"); sb.Append("The page title is \"" + Page.Header.Title + "\"."); PageMessage.Text = sb.ToString(); } </script> <html> <head runat="server"> <title>Page Class Example</title> </head> <body> <form id="form1" runat="server"> <div> <asp:Label id="PageMessage" runat="server"/> <br /> <br /> <asp:Button id="PageButton" Text="PostBack" runat="server" /> </div> </form> </body> </html>
- AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de demande : LinkDemand ; valeur d'autorisation : Minimal
- AspNetHostingPermission pour opérer dans un environnement hébergé. Valeur de demande : InheritanceDemand ; valeur d'autorisation : Minimal
Windows 98, Windows 2000 SP4, Windows Server 2003, Windows XP Édition Media Center, Windows XP Professionnel Édition x64, Windows XP SP2, Windows XP Starter Edition
Le .NET Framework ne prend pas en charge toutes les versions de chaque plate-forme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise.
