Como: Criar um receptor de eventos

  • Artigo

Receptores de evento são classes que permitem que você responda a eventos que ocorrem a itens como listas do SharePoint ou itens de lista. Quando alguém altera o calendário ou exclui um nome na lista de contatos, o código no caso de receptor é disparado.

Esta ajuda demonstra as seguintes tarefas:

  • Adicionando um receptor de eventos para uma instância de lista.

É necessário que os componentes a seguir para concluir estas etapas:

Você também deverá concluir o procedimento no tópico Demonstra Passo a passo: Criar um campo personalizado, o tipo de conteúdo, a definição de lista e a instância de lista.

Adicionando um receptor de eventos

O projeto que você criou na Demonstra Passo a passo: Criar um campo personalizado, o tipo de conteúdo, a definição de lista e a instância de lista inclui um campo personalizado, uma definição de lista personalizada com uma instância de lista e um tipo de conteúdo. Em seguida, você irá adicionar um receptor de eventos para o projeto. O procedimento a seguir adiciona um manipulador de eventos de simples (um receptor de eventos) para a instância de lista.

Para adicionar um receptor de eventos para a instância de lista

  1. Abra o projeto que você criou na Demonstra Passo a passo: Criar um campo personalizado, o tipo de conteúdo, a definição de lista e a instância de lista.

  2. Adicione um receptor de eventos para este projeto. Para fazer isso, clique no nó do projeto em Solution Explorer e selecione Add New Item sobre o projeto menu.

  3. Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.

  4. No modelos de painel, selecione Receptor de eventos e o nome TestEventReceiver1.

    O O Assistente para personalização do SharePoint aparece.

  5. Sobre o Escolha receptores de evento página, selecione Eventos de itens de lista como o tipo de receptor de evento.

  6. Definir o item de origem de evento para CustomField1 - ListDefinition1.

  7. Na lista de eventos para manipular, marque a caixa ao lado de um item foi adicionado e, em seguida, clique em Concluir.

  8. O novo arquivo de código do receptor do evento contém um único método chamado ItemAdded. Adicione código para este método para que toda vez que um contato é adicionado à lista de contatos, um padrão Nome do paciente valor de Scott Brown é usado. Para fazer isso, substituir o ItemAdded método com o seguinte:

    Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
    properties.ListItem("Patient Name") = "Scott Brown"
    properties.ListItem.Update()
    MyBase.ItemAdded(properties)
End Sub

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

  9. Pressione F5 para executar o código e exibir o site do SharePoint no navegador da Web.

  10. Na barra Inicialização rápida, clique em CustomField1 - ListInstance1.

    Esta é a instância de lista para a definição de lista. Observe que o Nome do paciente campo ainda não aparecer como uma coluna na instância de lista.

  11. Clique em lista na Lista de ferramentas guia na parte superior da página e clique o Modificar este modo de exibição botão na faixa.

  12. Na lista de nomes de coluna disponível, selecione Nome do paciente e, em seguida, clique em OK. Observe que o Nome do paciente campo aparecerá agora na instância de lista.

  13. Sobre o Ferramentas da lista na parte superior da página, clique em itens e, em seguida o Novo Item botão para exibir o formulário de entrada de dados.

  14. Insira os dados nos campos e clique no Salvar o botão na nova caixa de diálogo item da instância de lista.

    O Nome do paciente coluna automaticamente preenchida com Scott Brown, após clicar em OK.

Consulte também

Outros recursos

Desenvolvimento de soluções do SharePoint