A criação de páginas de aplicativo para o SharePoint

Artigo
08/08/2011

Um página de aplicativo é um aplicativo ASP.NET que foi projetado para uso em um site do SharePoint. As páginas de aplicativo são um tipo especializado de ASP.NET page. A principal diferença entre uma página de aplicativo e uma página ASP.NET é que uma página de aplicativo contém conteúdo que será mesclado com uma página mestra do SharePoint. Uma página mestra permite que as páginas de aplicativo compartilhar a mesma aparência e comportamento que outras páginas em um site.

Visual Studio permite a criação de páginas do aplicativo usando um designer. O designer exibirá uma área de conteúdo para cada espaço reservado para conteúdo que é definido em uma página mestra. Você pode estruturar a página de aplicativo arrastando controles a essas áreas de conteúdo.

Páginas de aplicativo

Páginas de aplicativo são compartilhadas entre todos os sites no servidor, enquanto uma página do site é específica a um site. Para obter mais informações, consulte Tipos de página do SharePoint.

Por padrão, a maioria das páginas que aparecem quando você cria um site do SharePoint é páginas do site. Uma página do site pode ser adicionada a uma biblioteca de página do SharePoint. Os usuários podem personalizar uma página do site usando ferramentas como o SharePoint Designer. Uma página do site também pode hospedar recursos como, por exemplo, de Web Parts dinâmico e zonas de Web Parts.

Páginas de aplicativo não podem fazer essas coisas. No entanto, uma página de aplicativo é o melhor tipo de página para criar se desejar que a página para conter o código personalizado. Embora seja possível adicionar o código personalizado para uma página do site, o código de execução será interrompida quando o usuário personaliza a página usando ferramentas como o SharePoint Designer.

Observação
Visual Studio não fornece modelos que ajudam você a criar páginas do site para um site do SharePoint. Para obter mais informações, consulte Tipos de página do SharePoint.

Criando uma página de aplicativo

Para criar uma página de aplicativo, adicione um Página de aplicativo item a um projeto do SharePoint. Quando você cria uma página de aplicativo, o Visual Studio adiciona as seguintes pastas para seu projeto:

Folder	Descrição
Layouts	Mapas de directório virtual do sistema de arquivos do SharePoint.
Subpasta de layouts	Contém os arquivos que compõem a página do aplicativo. Por padrão, essa pasta tem o mesmo nome de seu projeto. Você pode renomear esta pasta a qualquer momento. Quando você executar o projeto, Visual Studio implanta a esta pasta para o directório virtual do sistema de arquivos do SharePoint.

Visual Studio adiciona os seguintes arquivos ao seu projeto:

File	Descrição
ASP.NET (. aspx) de arquivo de paginação	Contém a marcação XML que define a página.
Arquivo de código de página de aplicativo	Contém o código da página do aplicativo. Adicione o código que manipula eventos para este arquivo.
Arquivo de código do designer de página de aplicativo	Contém o código gerado pelo designer. Não edite diretamente este arquivo.

Criação e depuração de uma página de aplicativo

O conteúdo de uma página de aplicativo de design usando o designer Visual Web Developer, no Visual Studio. Esse designer aparece quando você clica duas vezes na página do aplicativo em seu projeto. Para obter mais informações sobre como usar esse designer, consulte Mapa de conteúdo do Visual Web Developer.

Observação
Você só pode criar a página do fonte o modo de exibição do designer. O Design o modo de exibição do designer está desabilitado para páginas do aplicativo.

Você pode depurar uma página de aplicativo, assim como seria depurar a outros itens de projeto do SharePoint em Visual Studio. Quando você inicia o depurador de Visual Studio, Visual Studio abre o site do SharePoint.

Para exibir a página de aplicativo, você deve navegar manualmente para o local da página do aplicativo (por exemplo: http://nome_do_servidor/_layouts/Project_Name/ApplicationPage1.aspx).

Para obter mais informações sobre como depurar projetos do SharePoint, consulte Solucionando problemas de soluções do SharePoint.

Escolhendo uma página mestra

Por padrão, um Página de aplicativo item faz referência a página mestra do site que você está usando para depurar seu projeto. Que a página é denominada v4.master e você o encontrará na Galeria de páginas mestras do site do SharePoint.

Você pode alterar explicitamente a página mestra é usada pela página de aplicativo, definindo a MasterPageFile atributo do aplicativo Page elemento. (Por exemplo: MasterPageFile="~/_layouts/applicationv4.master"). Na verdade, você deve definir este atributo se páginas mestras dinâmicas não estiverem habilitadas no servidor do SharePoint. Para obter mais informações sobre páginas mestras no SharePoint, consulte Páginas mestras.