Criar um receptor de evento

  • Artigo

Criando receptores de eventos, você poderá responder quando um usuário interagir com itens do SharePoint, como listas ou itens de lista. Por exemplo, o código em um receptor de eventos pode ser disparado quando um usuário altera o calendário ou exclui um nome de uma lista de contatos. Seguindo este tópico, você pode aprender a adicionar um receptor de eventos a uma instância de lista.

Para concluir essas etapas, você precisa ter instalado o Visual Studio e as edições com suporte do Windows e do SharePoint. Como este exemplo requer um projeto do SharePoint, você também precisa ter concluído o procedimento no tópico Passo a passo: Criar uma coluna de site, um tipo de conteúdo e uma lista para o SharePoint.

Adicionando um receptor de eventos

O projeto que você criou no Passo a passo: Criar uma coluna de site, um tipo de conteúdo e uma lista para o SharePoint inclui colunas de site personalizadas, uma lista personalizada e um tipo de conteúdo. No procedimento a seguir, você expandirá esse projeto adicionando um manipulador de eventos simples (um receptor de eventos) a uma instância de lista para mostrar como lidar com eventos que ocorrem em itens do SharePoint, como listas.

Para adicionar um receptor de eventos à instância de lista

  1. Abra o projeto que você criou no Passo a passo: Criar uma coluna de site, um tipo de conteúdo e uma lista para o SharePoint.

  2. No Gerenciador de Soluções, escolha o nó do projeto do SharePoint que se chama Clínica.

  3. Na barra de menus, escolha Projeto>Adicionar Novo Item.

  4. No Visual C# ou no Visual Basic, expanda o nó SharePoint e escolha o item 2010.

  5. No painel Modelos, escolha Receptor de Eventos, dê a ele o nome TestEventReceiver1 e, em seguida, escolha o botão OK.

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

  6. Na lista Que tipo de receptor de eventos você deseja?, escolha Eventos de Item de Lista.

  7. Na lista Qual item deve ser a origem do evento?, escolha Pacientes (Clínica\Pacientes).

  8. Na lista Manipular os eventos a seguir, marque a caixa de seleção ao lado de Um item foi adicionado e escolha o botão Concluir.

    O arquivo de código do novo receptor de eventos contém um método chamado ItemAdded. Na próxima etapa, você adicionará código a esse método para que todo contato seja chamado de Scott Brown por padrão.

  9. Substitua o método ItemAdded existente pelo seguinte código e escolha a chave F5:

    public override void ItemAdded(SPItemEventProperties properties)
{
    properties.ListItem["Patient Name"] = "Scott Brown";
    properties.ListItem.Update();
    base.ItemAdded(properties);
}

    O código é executado e o site do SharePoint aparece no navegador da Web.

  10. Na barra QuickLaunch, escolha o link Pacientes e escolha o link Adicionar Novo Item.

    O formulário de entrada de novos itens é aberto.

  11. Insira dados nos campos e, em seguida, escolha o botão Salvar.

    Após você escolher o botão Salvar, a coluna Nome do Paciente é atualizada automaticamente para o nome Scott Brown.

Conteúdo relacionado