Partilhar 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 de aplicação 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.

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 para conteúdo definido em uma página mestra. Você pode criar a página do aplicativo arrastando controles para essas áreas de conteúdo.

Páginas de candidatura

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

As páginas de aplicativos não podem fazer essas coisas. No entanto, uma página de aplicativo é o melhor tipo de página para criar 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

Visual Studio não fornece modelos que ajudam 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 aplicação

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 seu projeto:

Folder Description
Layouts Mapeia para o diretório virtual _layouts do sistema de arquivos do SharePoint.
Subpasta Esquemas 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 diretório virtual _layouts do sistema de arquivos do SharePoint.

Visual Studio adiciona os seguintes arquivos ao seu projeto:

Ficheiro Description
ASP.NET arquivo de página (.aspx) Contém 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 código que manipula eventos a este arquivo.
Arquivo de código do designer de página da aplicação Contém código gerado pelo designer. Não edite diretamente este ficheiro.

Projetar e depurar uma página de aplicativo

Crie 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, em seguida, escolhendo Abrir) e, em seguida, escolha o botão Design na parte inferior do editor.

Observação

Você pode criar a página somente na visualização Código-fonte do designer. A visualização Design do designer está desativada 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 visualizar a página do aplicativo, você deve navegar 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.

Escolha uma página mestra

Por padrão, um item Página do Aplicativo faz referência à página mestra do site que você está usando para depurar seu projeto. Essa página é chamada 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 do 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.