Recurso receptor de eventos

Especifica uma rotina codificar server-side que é chamado como parte da chave quatro eventos na tempo de vida de um recurso: instalação, ativação, desativação e remoção.

Real World exemplo

Um desenvolvedor a criação de um recurso determina que ele deve fazer algumas chamadas para o modelo de objeto quando ativado e executar alguns limpeza quando desativado. Ele cria um classe receptor de eventos de recursos personalizado e inclui uma referência a ele na definição de recursos.

Detalhes Técnicos

Você compilação recursos receptores evento em conjuntos de módulos (assemblies) que é associado com a definição de um recurso. Se um recurso receptor está associado com esse recurso, quando o recurso passa por meio de um dos seus eventos ciclo de vida quatro ele é chamado com informações adicionais relacionadas ao escopo e destino desse evento.

O seguinte exemplo de código Feature.xml mostra como o receptor de recursos está registrado como parte da definição de recurso:

<Feature   Id="39FA56C4-7A47-44F5-83CC-01B5E777F436" Title="Feature with Receiver Callback" Scope="Web" ReceiverAssembly="SimpleReceiver, Version=1.0.0.0, Culture=neutral, PublicKeyToken=207e2bf263eeeff6, processorArchitecture=MSIL" ReceiverClass="MS.Samples.SharePoint.SimpleProvisioner" xmlns="https://schemas.microsoft.com/sharepoint/" />

Você pode usar recursos receptores evento para executar instalação adicional ou limpeza rotinas que ativação recurso núcleo e desativação não pode executar, such as excluindo arquivos que o recurso instalado em um site.

Detalhes de suporte

Porque um receptor de eventos de recursos pode ser chamado sempre que o recurso está ativado ou desativado, ele pode resultar em demora associado com o evento. Depending on a quantidade de codificar na receptor de eventos de recursos, isso poderia causar um atraso significativo se um novo recurso for adicionado à ou removido de vários locais em um tempo (por exemplo, a ativação de um recurso em cada site em um ambiente SharePoint muito grande).