Passo a passo: Criar um projeto de definição de site básico

Este passo a passo mostra como criar uma definição de site básico que contém uma Web Part visual com alguns controles. Para fins de clareza, a Web Part visual que você cria tem apenas alguns controles. No entanto, você pode criar definições de site mais sofisticadas do SharePoint que incluem mais funcionalidade.

Este passo a passo demonstra as seguintes tarefas:

• Criando uma definição de site usando o modelo de projeto do Visual Studio.

• Criando um site do SharePoint usando uma definição de site no SharePoint.

• Adicionando uma Web Part visual à solução.

• Personalizando a página default.aspx do site adicionando a nova Web Part visual.

  Observação

  Seu computador pode mostrar diferentes nomes ou locais para alguns dos elementos de interface do usuário do Visual Studio nas instruções a seguir. A edição do Visual Studio que você possui e as configurações que você usa determinam esses elementos. Para obter mais informações, confira Personalizar o IDE.

Pré-requisitos

Você precisará dos seguintes componentes para concluir este passo a passo:

• Edições do Microsoft Windows e do SharePoint com suporte. Para obter mais informações, confira Requisitos para desenvolver soluções do SharePoint.

• Visual Studio.

Criar uma solução de definição de site

Primeiro, crie o projeto de definição de site no Visual Studio.

Para criar um projeto de definição do site

1. Na barra de menus, escolha Arquivo>Novo>Projeto. Se o IDE estiver definido para usar as configurações de desenvolvimento do Visual Basic, na barra de menus, escolha Arquivo>Novo Projeto.

   A caixa de diálogo Novo Projeto aparecerá.

2. Expanda o nó Visual C# ou o nó Visual Basic, expanda o nó SharePoint e escolha o nó 2010.

3. Na lista Modelos, escolha o modelo Projeto do SharePoint 2010.

4. Na caixa Nome insira TestSiteDef e, em seguida, escolha o botão OK.

   O Assistente de Personalização do SharePoint é exibido.

5. Na página Especificar o site e o nível de segurança para depuração, insira a URL do site do SharePoint em que você deseja depurar a definição do site ou use o local padrão (http://System Name/).

6. Na seção Qual é o nível de confiança para esta solução do SharePoint?, clique no botão da opção Implantar como uma solução de farm.

   Todos os projetos de definição de site devem ser implantados como soluções de farm. Para obter mais informações sobre soluções de área restrita versus soluções de farm, confira Considerações sobre a solução em área restrita.

7. Escolha o botão Concluir.

   O projeto aparece no Gerenciador de Soluções.

8. Em Gerenciador de Soluções, escolha o nó do projeto e, na barra de menus, escolha Projeto>Adicionar Novo Item.

9. Em Visual C# ou Visual Basic, expanda o nó SharePoint e escolha o nó 2010.

10. No painel Modelos, escolha o modelo Definição de Site, deixe o Nome como SiteDefinition1 e escolha o botão Adicionar.

Criar uma Web Part visual

Em seguida, crie uma Web Part visual para aparecer na página principal da definição do site.

Para criar uma Web Part visual

1. No Gerenciador de Soluções, escolha o botão Mostrar Todos os Arquivos.

2. Escolha o nó do projeto SiteDefinition1 e, na barra de menus, escolha Projeto>Adicionar Novo Item.

   A caixa de diálogo Adicionar Novo Item aparecerá.

3. Expanda o nó Visual C# ou o nó Visual Basic, expanda o nó SharePoint e escolha o nó 2010.

4. Na lista de modelos, escolha o modelo Web Part visual, mantenha o nome padrão VisualWebPart1 e escolha o botão Adicionar.

   O arquivo VisualWebPart1.ascx é aberto.

5. Na parte inferior do VisualWebPart1.ascx, adicione a seguinte marcação para adicionar três controles ao formulário: uma caixa de texto, um botão e um rótulo:

   <table>
     <tr>
       <td>
         <asp:TextBox runat="server" ID="tbName"></asp:TextBox>
       </td>
       <td>
         <asp:Button runat="server" ID="btnSubmit" Text = "Change Label Text" OnClick="btnSubmit_Click"></asp:Button>
       </td>
       <td>
         <asp:Label runat="server" ID="lblName"></asp:Label>
       </td>
     </tr>
   </table>
   

6. Em VisualWebPart1.ascx, abra o arquivo VisualWebPart1.ascx.cs (para Visual C#) ou VisualWebPart1.ascx.vb (para Visual Basic) e adicione o seguinte código:

   C#

   protected void btnSubmit_Click(object sender, EventArgs e)
   {            
       lblName.Text = tbName.Text;
   }
   

   VB

   Protected Sub btnSubmit_Click(ByVal sender As Object, ByVal e As EventArgs)
       lblName.Text = tbName.Text
   End Sub
   

   Esse código adiciona funcionalidade para o clique de botão da Web Part.

Adicionar a Web Part visual à página ASPX padrão

Em seguida, adicione a Web Part visual à página ASPX padrão da definição de site.

Para adicionar uma Web Part visual à página ASPX padrão

1. Abra a página default.aspx e adicione a seguinte linha sob a marca WebPartPages:

   <%@ Register Tagprefix="MyWebPartControls" Namespace="TestSiteDef.VisualWebPart1" Assembly="$SharePoint.Project.AssemblyFullName$" %>
   

   Essa linha associa o nome MyWebPartControls à Web Part e seu código. O parâmetro Namespace corresponde ao namespace usado no arquivo de código VisualWebPart1.ascx.

2. Após o elemento </asp:Content>, substitua a seção ContentPlaceHolderId="PlaceHolderMain" inteira e seu conteúdo pelo seguinte código:

   <asp:Content ID="Content1" ContentPlaceHolderId="PlaceHolderMain" runat="server">
       <MyWebPartControls:VisualWebPart1 runat="server" />
   </asp:Content>
   

   Esse código cria uma referência à Web Part visual que você criou anteriormente.

3. No Gerenciador de Soluções, abra o menu de atalho do nó SiteDefinition1 e escolha Definir como Item de Inicialização.

Implantar e executar a solução de definição do site

Em seguida, implante o projeto no SharePoint e execute-o.

Para implantar e executar a definição do site

• Na barra de menus, escolha Compilar>Implantar TestSiteDef.

• Pressione a tecla F5.

  O Visual Studio compila o código, adiciona seus recursos, empacota todos os arquivos em um arquivo de solução do SharePoint (WSP) e implanta o arquivo WSP no SharePoint Server. Em seguida, o SharePoint instala os arquivos e ativa os recursos.

Criar um site com base na definição do site

Em seguida, crie um site usando a nova definição do site.

Para criar um site usando a definição do site

1. No site do SharePoint, a página Novo Site do SharePoint é exibida.

2. Na seção Título e Descrição, insira Meu Novo Site para o título e uma descrição do site.

3. Na seção Endereço do Site, insira mynewsite na caixa Nome da URL.

4. Na seção Modelo, escolha a guia Personalizações do SharePoint.

5. Na lista Selecionar um modelo, escolha SiteDefinition1.

6. Deixe as outras configurações com seus valores padrão e escolha o botão Criar.

   O novo site é exibido.

Testar o novo site

Em seguida, teste o novo site para verificar se ele funciona corretamente.

Para testar o novo site

• Na página ASPX padrão, insira um texto e escolha o botão Alterar Texto do Rótulo ao lado da caixa de texto.

  O texto aparece no rótulo no lado direito do botão.

Conteúdo relacionado

• Como criar um receptor de evento
• Desenvolver soluções do SharePoint