Registrar um manipulador de eventos

Artigo
11/27/2008

Manipuladores de evento são registrados de forma diferente no Windows SharePoint Services 3.0 devido novos conceitos como de conteúdo tipos e recursos que ele apresenta. Para motivos compatibilidade com versões anteriores, no entanto, Windows SharePoint Services 3.0 oferece suporte o registro existente de eventos biblioteca. O EventSinkAssembly, EventSinkClass e as propriedades EventSinkData EventSinkData continuam a função e são exposta na interface de usuário.

Em Windows SharePoint Services 3.0, existem três maneiras fundamentais para registrar um manipulador de eventos:

Através de modelo de objeto, como o SPWeb e SPList classes agora cada fornecem uma propriedade EventReceivers através do qual para acessar a coleção de receptor de eventos Definições do site ou lista. Você pode adicionar novo evento receptores por chamado o Add método Overload:Microsoft.SharePoint.SPEventReceiverDefinitionCollection.Add.
Declarativamente por tipo lista, de exemplo, para registrar um manipulador de eventos para todas as listas de avisos. Em um arquivo Feature.XML, você pode registrar um manipulador de eventos, ID. modelo lista Quando o recurso contendo é ativado por objeto SPWeb T:Microsoft.SharePoint.SPWeb, você pode registrar o manipulador de eventos para qualquer lista do tipo especificado.
Declarativamente por tipo de conteúdo, de exemplo, para registrar um manipulador de eventos para todos os documentos de um tipo específico. Dentro de XML para uma definição tipo de conteúdo, você pode registrar evento receptores.

Observação O assembly que contém o manipulador de eventos deve ser altamente nomeado e registrado na cache global de assemblies (GAC) a ser usado. Você não pode operar conjuntos de módulos (assemblies) receptor de eventos da pasta \_app_bin ( Local_Drive :\Inetpub\wwwroot\wss\VirtualDirectories\ GUID \_app_bin).

Tipos de conteúdo

Windows SharePoint Services 3.0 apresenta a concepção do de conteúdo tipos na armazenamento de dados. Em breve, de conteúdo tipos apresentar a noção de reutilização para trabalhar com os serviços SharePoint Windows Designers da Web. Os Web Designers agora têm a capacidade criar classes de objetos com definições específicas e possíveis associado comportamento, como Nome tipo, campos, formato, processos empresa, retenção, auditoria e manipulação de eventos. Agora você pode ativar SharePoint listas e bibliotecas para suporte múltiplo de conteúdo tipos. Quando fizer isso, você pode anexar um ou mais dessas classes à sua lista ou biblioteca e, portanto, estender com funcionalidade adicional e comportamento. Pense estendendo uma lista cliente com um tipo de conteúdo de contatos. O tipo de conteúdo de contatos pode fornecer a lista do cliente com um conjunto de novos campos, como Contact Name, função, telefone e SO Forth e também com o novo comportamento.

Agora você pode definir manipuladores evento para um tipo de conteúdo específico. Você pode, de exemplo, definir a tipo de conteúdo "cliente", e em seu comportamento, você pode definir os metadados para o manipulador de eventos.

Recursos

Você define de conteúdo tipos usando um recurso. Ao definir um tipo de conteúdo com um recurso, você cria dois arquivos XML como mostrado abaixo:

Feature.xml você usar este arquivo XML para definir os metadados para o novo recurso. O seguinte exemplo codificar escopos o recurso no nível do site e define um identificador exclusivo para o novo recurso. Usando o elemento ElementManifests ElementManifests, ele e pontos para a localidade do segundo arquivo XML armazenar todas as informações detalhadas no recurso próprio.
```
                        <?xml version="1.0" encoding="utf-8"?>
<Feature Scope="Web" 
  Title="Simple Event Handler Registration" 
  Id="A6B8687A-3200-4b01-AD76-09E8D163FB9A" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml"/>
  </ElementManifests>
</Feature>
```

ELEMENTS.xml você usar esse arquivo para definir o assembly que encapsula o manipulador de eventos, a classe próprio e também um número seqüência que especifica a ordem, se múltiplo são manipuladores evento associado com o recurso. O seguinte exemplo registra evento receptores para excluir e adicionar itens.

                        <?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <Receivers ListTemplateId="104">
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemDeleting</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
    <Receiver>
      <Name>MyEventHandlers</Name>
      <Type>ItemAdded</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>MyEventHandlers, Version=1.0.0.0, Culture=neutral, PublicKeyToken=4358f2a5344ff0dc</Assembly>
      <Class>MyEventHandlers.SimpleEventHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
  </Receivers>
</Elements>

Consulte também

Compartilhar via

Registrar um manipulador de eventos

Tipos de conteúdo

Recursos

Consulte também

Tarefas

Conceitos

Outros recursos

Recursos adicionais