Creación de páginas de aplicación para SharePoint

  • Artículo

Una página de aplicación es una página web de 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 tiene contenido que se combina con una página maestra de SharePoint. Una página maestra permite que las páginas de aplicaciones compartan 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, consulte 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 para crear si desea que la página contenga código personalizado. Aunque puede agregar código personalizado a una página del 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, consulte 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 Descripción
Diseños Se asigna al directorio virtual _layouts del sistema de archivos de SharePoint.
Subcarpeta Layouts 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 Descripción
Archivo de página ASP.NET (.aspx) Contiene marcado XML que define la página.
Archivo de código de página de la aplicación Contiene código subyacente a la página de la aplicación. Agregue código que controle eventos en este archivo.
Archivo de código del diseñador de páginas de aplicaciones 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, elige el botón Diseño en la parte inferior del editor.

Nota

Solo 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 la 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 navegar 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.

Elección de una página maestra

De forma predeterminada, un elemento Página de aplicación hace referencia a la página maestra del sitio que está usando para depurar el proyecto. Esa página se denomina v4.master y puede encontrarla en la Galería de páginas maestras del sitio de SharePoint.

Puede cambiar explícitamente qué página maestra usa la página de aplicación estableciendo el atributo MasterPageFile del elemento Page de la aplicación. (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.

Contenido relacionado