Cette documentation est archivée et n’est pas conservée.

Page, classe

Représente un fichier .aspx, également appelé page Web Forms, demandé à un serveur qui héberge une application Web ASP.NET.

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

public class Page : TemplateControl, IHttpHandler
public class Page extends TemplateControl implements IHttpHandler
public class Page extends TemplateControl implements IHttpHandler

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.

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

Les membres statiques publics (Shared en Visual Basic) de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

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.

.NET Framework

Prise en charge dans : 2.0, 1.1, 1.0
Afficher: