Compartilhar via


Registros de eventos

Registrar manipuladores evento no site ou site coleção nível que você usará para implementar filtragem para responder a eventos item da lista.

O elemento 1290b4ef-956f-4775-82cc-07f9b812c0f9 Receivers especifica um manipulador de eventos de item da lista Eventos.

Elementos

  Receptores

    Receptor

      Nome

      Tipo

      SequenceNumber

      Conjunto de Módulos (Assembly)

      Classe

      Dados

Exemplo

Para registrar um manipulador de eventos para lista Eventos, crie uma pasta no \Template\Features para conter um arquivo caa75c38-9788-4727-a2a8-ab92df90a256 Feature.XML que especifica o escopo e identificação do recurso e um arquivo de manifesto elementos que o antigo arquivo referências.

Talvez o arquivo Feature.xml que registra um manipulador de eventos aspecto como o seguinte.

                    <Feature 
  Scope="Web" 
  Title="Simple Updating Item Event Handler Registration" 
  Id="A6B8687A-3200-4b01-AD76-09E8D163FB9A" 
  xmlns="https://schemas.microsoft.com/sharepoint/">
  <ElementManifests>
    <ElementManifest Location="elements.xml"/>
  </ElementManifests>
</Feature>

O arquivo de manifesto elementos registra o assembly manipulador de eventos e o associa com um tipo lista, que o seguinte exemplo especifica a ser comunicado listas (104).

                    <Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <Receivers 
    ListTemplateOwner="ADDABAAA-1111-2222-3333-111111111111" 
    ListTemplateId="104">
    <Receiver>
      <Name>SimpleUpdateEvent</Name>
      <Type>ItemUpdating</Type>
      <SequenceNumber>10000</SequenceNumber>
      <Assembly>SimpleUpdateEventHandler, Version=1.0.0.0, Culture=neutral, PublicKeyToken=10b23036c9b36d6d</Assembly>
      <Class>MS.Samples.SimpleItemUpdateHandler</Class>
      <Data></Data>
      <Filter></Filter>
    </Receiver>
  </Receivers>
</Elements>

O arquivo. cs para o manipulador de eventos pode usar o modelo de objeto Windows SharePoint Services wssnoversshort para responder a eventos. Para informações sobre como usar o modelo objeto para criar personalizado manipuladores evento, consulte Conceitos básicos de eventos.

O seguinte exemplo define o de conteúdo de uma mensagem de erro para exibir quando usuários tentam modificar itens em uma lista.

                    using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.SharePoint;

namespace MS.Samples
{
    public class SimpleItemUpdateHandler : SPItemEventReceiver
    {
        public override void ItemUpdating(SPItemEventProperties properties)
        {
            properties.Cancel = true;
            properties.ErrorMessage = "Updating data is not supported.";
        }
    }
}

Consulte também

Tarefas

Como a: criar um recurso do manipulador de eventos

Outros recursos

Conceitos básicos de eventos