Criar páginas de aplicativo para o SharePoint

  • Artigo

Uma página de aplicativo é uma página da Web ASP.NET projetada para uso em um site do SharePoint. Páginas de aplicativo são um tipo especializado de página ASP.NET. A principal diferença entre uma página de aplicativo e uma página ASP.NET padrão é que uma página de aplicativo tem conteúdo mesclado com uma página mestra do SharePoint. Uma página mestra permite que páginas do aplicativo compartilhem a mesma aparência e comportamento que outras páginas em um site.

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

Páginas de aplicativo

Páginas de aplicativo são compartilhadas em todos os sites no servidor, enquanto uma página de site é específica de 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 são páginas de site. Uma página de site pode ser adicionada a uma biblioteca de páginas do SharePoint. Os usuários podem personalizar uma página de site usando ferramentas como o SharePoint Designer. Uma página de site também pode hospedar recursos como Web Parts dinâmicas e Zonas de Web Parts.

Páginas de aplicativo não podem fazer isso. No entanto, uma página de aplicativo é o melhor tipo de página a ser criada quando você quer que a página contenha código personalizado. Embora você possa adicionar código personalizado a uma página de site, o código para de ser executado quando o usuário personaliza a página usando ferramentas como o SharePoint Designer.

Observação

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

Criar uma página de aplicativo

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

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

O Visual Studio adiciona os seguintes arquivos ao projeto:

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

Projetar e depurar uma página de aplicativo

Projete o conteúdo de uma página de aplicativo usando o modo de exibição de designer no Visual Studio. Esse designer aparece quando você abre a página de aplicativo em seu projeto (clicando duas vezes nela ou abrindo o menu de atalho e escolhendo Abrir) e, em seguida, escolhe o botão Design na parte inferior do editor.

Observação

Você pode projetar a página somente no modo de exibição Origem do designer. O modo de exibição de Design fica desabilitado para páginas de aplicativo.

Você pode depurar uma página de aplicativo da mesma forma como depuraria outros itens de projeto do SharePoint no Visual Studio. Quando você inicia o depurador do Visual Studio, o Visual Studio abre o site do SharePoint.

Para exibir a página de aplicativo, navegue manualmente até o local da página de aplicativo (por exemplo: http://Server_Name/_layouts/Project_Name/ApplicationPage1.aspx).

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

Escolher uma página mestra

Por padrão, um item Página de Aplicativo faz referência à página mestra do site que você está usando para depurar o projeto. Essa página se chama v4.master e você pode encontrá-la listada na Galeria de Páginas Mestras do site do SharePoint.

Você pode alterar explicitamente qual página mestra é usada pela página de aplicativo definindo o atributo MasterPageFile do elemento Page do aplicativo. (Por exemplo: MasterPageFile="~/_layouts/applicationv4.master"). Na verdade, você precisará definir esse atributo se as 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.

Conteúdo relacionado