O que há de novo com manipuladores de eventos

Muitos desenvolvedores usam manipuladores de evento no Windows SharePoint Services para executar personalizado código gerenciado por trás de bibliotecas documento ou forma bibliotecas. A meta de Windows SharePoint Services 3.0 é fornecer aos desenvolvedores com uma plataforma ainda mais rica para desenvolvimento personalizado pontos integração e compilação novos tipos de aplicativos em parte superior da infra-estrutura. Para essa finalidade, manipuladores de evento em Windows SharePoint Services 3.0 são estendido no escopo e profundidade em várias maneiras.

As alterações do manipulador de eventos

As novas extensões mais importantes para manipuladores de evento incluem o seguinte:

Maior Escopo de eventos

O escopo de eventos é aumentado e agora aborda as bibliotecas não apenas o documento e forma mas também listas e alguns limitado site e site Eventos coleção.

• Eventos que são acionados por listas permitem que você gancho backup codificar quando lista os itens são adicionados, alterados ou removido, significa que você pode criar personalizado comportamento por código gerenciado Microsoft.NET.

  Observação

  Para documentos, Before e After são garantidas para eventos postagem, como ItemUpdated, antes de mas Before antes de propriedades não estão disponível para eventos postagem em lista itens.

• Eventos que ocorrer quando um usuário adiciona ou remove campos para uma lista.

• Eventos que ocorrer quando uma coleção site ou site é excluída.

  Observação

  Windows SharePoint Services oferece suporte à configuração Eventos exclusão site pelo modelo de objeto, mas não através de personalizado Recursos.

Maior profundidade e Richness de eventos

A profundidade e a riqueza dos eventos também é uma principal novo aprimoramento, e agora existem principal dois tipos de eventos:

• Before \endash eventos que ocorre acionar antes uma ação permitem que você executar personalizado validação, a verificação, ou processamento de dados que está prestes a ser excluído, modificado ou adicionado a uma lista. These types of events are consistently suffixed with 'ing' to identify them as Before events. Observe que a codificar reagir sobre esses eventos é executado em um síncrono maneira.

• After wssversion2 Windows SharePoint Services 2,0. Esses eventos são terminam com 'ed' e a manipulação codificá-los é executado de forma assíncrona.

Maior flexibilidade do manipulador de eventos

Manipuladores de evento são registrados de forma diferente do que no Windows SharePoint Services 2,0, na qual ele foi possível anexar apenas um assembly por biblioteca documento ou forma. Em Windows SharePoint Services 3.0, você tem mais flexibilidade na manipulação e registrando seus eventos.

Capacidade para se comunicar respostas voltar para a interface do usuário

Com Windows SharePoint Services 3.0, você pode se comunicar respostas voltar a interface de usuário. Assumir, de exemplo, um cenário no qual um usuário tenta adicionar um novo item e um manipulador de eventos invalida dessa entrada because of alguns lógica corporativa. Este maiúsculas e minúsculas, você pode criar uma mensagem de erro that is comunicada voltar para o usuário.

A criação de site da Web ou eventos de exclusão

Você pode criar um manipulador de eventos para o evento T:Microsoft.SharePoint.SPWebEventReceiver.WebDeleted WebDeletingWebDeleted ou forma que quando um site é excluída, ela é primeiro backup e armazenada em um arquivo morto para recuperação fácil. For the backup mechanism, use the Backup method if the root Web site is deleted; otherwise, use the SPExport class.

Para registrar um callback que aciona cada tempo um novo site é criada em uma coleção site ou globalmente dentro uma implantação, você pode criar um recurso para que ocorrer textos explicativos ativação quando o recurso está ativado. Como recursos podem ser delimitados para um site, criar um recurso que é ativado cada tempo que um site é criado fornece um evento de criação site. Para informações sobre como associar um recurso com definições site de um tipo específico, consulte Recurso/sites de associação do modelo.

Consulte também

Conceitos

Guia de Introdução Com programaticamente personalizar uma Web Site SharePoint em Visual Studio
A validação de segurança e fazer postagens para atualizar os dados
Elevação de privilégio
Trabalhando com recursos