Esta documentación está archivada y no tiene mantenimiento.

Page (Clase)

Representa un archivo .aspx, también conocido como página de formularios Web Forms, solicitado desde un servidor que aloja una aplicación Web ASP.NET.

Espacio de nombres: System.Web.UI
Ensamblado: System.Web (en system.web.dll)

public class Page : TemplateControl, IHttpHandler
public class Page extends TemplateControl implements IHttpHandler
public class Page extends TemplateControl implements IHttpHandler
No aplicable.

La clase Page se asocia a archivos que tienen la extensión .aspx. Estos archivos se compilan en tiempo de ejecución como objetos Page y se almacenan en la memoria caché del servidor.

Si desea crear una página de formularios Web Forms mediante la técnica de código subyacente, derívela de esta clase. Los diseñadores de desarrollo rápido de aplicaciones (RAD), como Microsoft Visual Studio, utilizan automáticamente este modelo para crear páginas de formularios Web Forms.

El objeto Page hace las veces de contenedor de nombres de todos los controles de servidor de una página, excepto los que implementan la interfaz INamingContainer o los elementos secundarios de controles que implementen esta interfaz.

La clase Page es un control que actúa como interfaz de usuario de la aplicación Web y, como tal, deber revisarse con mucha atención para garantizar que se cumplen los procedimientos recomendados para la escritura de código y la protección de aplicaciones. Para obtener información general sobre estos temas, vea Información general sobre las amenazas para la seguridad de las aplicaciones Web, Procedimientos recomendados para directivas de seguridad y Conceptos clave de seguridad. Para obtener información más concreta, vea Seguridad de controles estándar, Cómo: Mostrar mensajes de error seguros, Cómo: Proteger una aplicación Web frente a ataques mediante secuencias de comandos aplicando codificación HTML a las cadenas e Introducción a los controles de validación.

En el ejemplo de código siguiente se muestra cómo la clase Page se utiliza en el modelo de página de código subyacente. Observe que el archivo de código fuente subyacente declara una clase parcial que hereda de una clase de página base. La clase de página base puede ser Page o puede ser otra clase que derive de Page. Además, observe que la clase parcial permite al archivo de código subyacente utilizar controles definidos en la página sin la necesidad de definirlos como miembros de campo.

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 + ".";

    }
}

En el ejemplo de código siguiente se muestra el archivo .aspx que corresponde al archivo de código fuente subyacente anterior.

Nota de seguridadNota: de seguridad

Este ejemplo tiene un cuadro de texto que acepta datos del usuario, lo que puede suponer una amenaza para la seguridad. De forma predeterminada, las páginas Web ASP.NET validan que los datos proporcionados por el usuario no incluyen elementos HTML ni de secuencia de comandos. Para obtener más información, vea Información general sobre los ataques mediante secuencias de comandos.

<%@ Page Language="C#" CodeFile="pageexample.aspx.cs" Inherits="MyCodeBehindCS" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
    <title>Page Class Example</title>
</head>
<body>
    <form id="form1" 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>

Debe utilizar la directiva @ Page y los atributos Inherits y CodeFile para vincular el archivo de código subyacente al archivo .aspx. En este ejemplo, el atributo Inherits indica la clase MyCodeBehind y el atributo CodeFile indica la ruta de acceso al archivo específico del idioma que contiene la clase.

En el ejemplo de código siguiente se muestra el modelo de página de un solo archivo y cómo tener acceso a las propiedades IsPostBack y Response de Page.

<%@ Page Language="C#" %>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<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 xmlns="http://www.w3.org/1999/xhtml" >
<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  para trabajar en un entorno alojado en host. Valor de petición: LinkDemand; valor de permiso: Minimal.
  • AspNetHostingPermission  para trabajar en un entorno alojado en host. Valor de petición: InheritanceDemand; valor de permiso: Minimal.

Los miembros estáticos públicos (Shared en Visual Basic) de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Windows 98, Windows 2000 Service Pack 4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter

Microsoft .NET Framework 3.0 es compatible con Windows Vista, Microsoft Windows XP SP2 y Windows Server 2003 SP1.

.NET Framework

Compatible con: 3.0, 2.0, 1.1, 1.0
Mostrar: