Compartilhar via


Criar páginas de aplicativo para o SharePoint

Uma página de aplicativo é uma página da Web ASP.NET projetada para uso em um site do SharePoint. As páginas do aplicativo são um tipo especializado de página de ASP.NET. A principal diferença entre uma página de aplicativo e uma página de ASP.NET padrão é que uma página de aplicativo contém conteúdo mesclado com uma página mestra do SharePoint. Uma página mestra permite que as 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 aplicativos 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 do aplicativo arrastando controles para essas áreas de conteúdo.

Páginas do aplicativo

As páginas do aplicativo são compartilhadas em todos os sites no servidor, enquanto uma página do site é específica para um site. Para obter mais informações, 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 do 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 do site também pode hospedar recursos, como Web Parts dinâmicas e Zonas de Web Parts.

As páginas do aplicativo não podem fazer essas coisas. No entanto, uma página de aplicativo é o melhor tipo de página a ser criada se você quiser que a página contenha código personalizado. Embora você possa adicionar código personalizado a uma página do 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 da Página do Aplicativo a um projeto do SharePoint. Quando você cria uma página de aplicativo, o Visual Studio adiciona as seguintes pastas ao seu projeto:

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

O Visual Studio adiciona os seguintes arquivos ao seu projeto:

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

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 do aplicativo em seu projeto (clicando duas vezes nele ou abrindo seu menu de atalho e escolhendo Abrir) e, em seguida, escolha o botão Design na parte inferior do editor.

Observação

Você pode projetar a página somente no modo Origem do designer. A visão de Design do ambiente de desenvolvimento está desabilitada para páginas de aplicação.

Você pode depurar uma página de aplicativo da mesma forma que 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 do aplicativo, navegue manualmente até o local da página do 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 de soluções do SharePoint.

Escolher uma página mestra

Por padrão, um item da Página de Aplicativo faz referência à página mestra do site que você está usando para depurar seu 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 do aplicativo definindo o MasterPageFile atributo do elemento de aplicativo Page . (Por exemplo: MasterPageFile="~/_layouts/applicationv4.master"). Na verdade, você deve 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.