Como: Criar um receptor de eventos
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:
Edições com suporte do Microsoft Windows e do SharePoint. Para obter mais informações, consulte Requisitos para o desenvolvimento de soluções do SharePoint.
Visual Studio 2010.
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
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.
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.
Expanda o SharePoint o nó em um Visual C# ou Visual Basice, em seguida, clique em 2010.
No modelos de painel, selecione Receptor de eventos e o nome TestEventReceiver1.
O O Assistente para personalização do SharePoint aparece.
Sobre o Escolha receptores de evento página, selecione Eventos de itens de lista como o tipo de receptor de evento.
Definir o item de origem de evento para CustomField1 - ListDefinition1.
Na lista de eventos para manipular, marque a caixa ao lado de um item foi adicionado e, em seguida, clique em Concluir.
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); }
Pressione F5 para executar o código e exibir o site do SharePoint no navegador da Web.
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.
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.
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.
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.
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.