Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Una página de aplicación es una página web ASP.NET diseñada para su uso en un sitio web de SharePoint. Las páginas de aplicación son un tipo especializado de página de ASP.NET. La principal diferencia entre una página de aplicación y una página de ASP.NET estándar es que una página de aplicación contiene contenido que se combina con una página maestra de SharePoint. Una página maestra permite a las páginas de aplicación compartir la misma apariencia y comportamiento que otras páginas de un sitio.
Visual Studio permite diseñar páginas de aplicación mediante un diseñador. El diseñador muestra un área de contenido para cada marcador de posición de contenido definido en una página maestra. Puede diseñar la página de la aplicación arrastrando controles a estas áreas de contenido.
Páginas de aplicación
Las páginas de aplicación se comparten en todos los sitios del servidor, mientras que una página de sitio es específica de un sitio. Para obtener más información, Tipos de página de SharePoint.
De forma predeterminada, la mayoría de las páginas que aparecen al crear un sitio de SharePoint son páginas de sitio. Se puede agregar una página de sitio a una biblioteca de páginas de SharePoint. Los usuarios pueden personalizar una página de sitio mediante herramientas como SharePoint Designer. Una página de sitio también puede hospedar características como elementos web dinámicos y zonas de elementos web.
Las páginas de aplicación no pueden hacer estas cosas. Sin embargo, una página de aplicación es el mejor tipo de página que se va a crear si desea que la página contenga código personalizado. Aunque puede agregar código personalizado a una página de sitio, el código deja de ejecutarse cuando el usuario personaliza la página mediante herramientas como SharePoint Designer.
Nota:
Visual Studio no proporciona plantillas que le ayudan a crear páginas de sitio para un sitio de SharePoint. Para obtener más información, vea Tipos de página de SharePoint.
Creación de una página de aplicación
Para crear una página de aplicación, agregue un elemento Página de aplicación a un proyecto de SharePoint. Al crear una página de aplicación, Visual Studio agrega las siguientes carpetas al proyecto:
| Carpeta | Description |
|---|---|
| Layouts | Mapea al directorio virtual _layouts del sistema de archivos de SharePoint. |
| Subcarpeta Diseños | Contiene los archivos que componen la página de la aplicación. De forma predeterminada, esta carpeta tiene el mismo nombre que el proyecto. Puede cambiar el nombre de esta carpeta en cualquier momento. Al ejecutar el proyecto, Visual Studio implementa esta carpeta en el directorio virtual _layouts del sistema de archivos de SharePoint. |
Visual Studio agrega los siguientes archivos al proyecto:
| Archivo | Description |
|---|---|
| archivo de página ASP.NET (.aspx) | Contiene marcado XML que define la página. |
| Archivo de código de página de aplicación | Contiene código subyacente a la página de la aplicación. Agregue código que controle eventos a este archivo. |
| Archivo de código del diseñador de páginas de aplicación | Contiene código generado por el diseñador. No edite directamente este archivo. |
Diseño y depuración de una página de aplicación
Diseñe el contenido de una página de aplicación mediante la vista del diseñador en Visual Studio. Este diseñador aparece cuando abre la página de la aplicación en el proyecto (haciendo doble clic en él o abriendo su menú contextual y, a continuación, seleccionando Abrir) y, a continuación, elija el botón Diseño en la parte inferior del editor.
Nota:
Usted únicamente puede diseñar la página en la vista Origen del diseñador. La vista Diseño del diseñador está deshabilitada para las páginas de aplicación.
Puede depurar una página de aplicación igual que depuraría otros elementos de proyecto de SharePoint en Visual Studio. Al iniciar el depurador de Visual Studio, Visual Studio abre el sitio de SharePoint.
Para ver la página de la aplicación, debe ir manualmente a la ubicación de la página de la aplicación (por ejemplo: http:// Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).
Para obtener más información sobre cómo depurar proyectos de SharePoint, vea Solución de problemas de soluciones de SharePoint.
Elegir una página maestra
De forma predeterminada, un elemento Página de la aplicación hace referencia a la página maestra del sitio que usa para depurar el proyecto. Esa página se denomina v4.master y puede encontrarlo en la Galería de páginas maestras del sitio de SharePoint.
Puede cambiar explícitamente la página maestra que usa la página de la aplicación estableciendo el MasterPageFile atributo del elemento de aplicación Page . (Por ejemplo: MasterPageFile="~/_layouts/applicationv4.master"). De hecho, debe establecer este atributo si las páginas maestras dinámicas no están habilitadas en el servidor de SharePoint. Para obtener más información sobre las páginas maestras en SharePoint, vea Páginas maestras.