Compartilhar via

Registros de evento

Aplica-se a: SharePoint 2016 | SharePoint Foundation 2013 | | do SharePoint Online SharePoint Server 2013

Registre manipuladores de eventos no nível do site ou da coleção de sites que você usará para implementar a filtragem para responder aos eventos.

O elemento Receivers especifica um manipulador de eventos para eventos de item de lista.

Exemplo

Para registrar um manipulador de eventos para eventos de lista, crie uma pasta \\Template\\Features para conter um arquivo Feature.xml que especifica o escopo e a ID do Recurso e um arquivo de manifesto de elementos que o arquivo anterior referencia.

O arquivo Feature.xml que registra um manipulador de eventos pode se parecer com o seguinte.

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

O arquivo de manifesto de elementos registra o assembly do manipulador de eventos e o associa a um tipo de lista, que o exemplo a seguir especifica como listas de anúncios (104).

    <Elements xmlns="http://schemas.microsoft.com/sharepoint/">
      <Receivers
        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>
        </Receiver>
      </Receivers>
    </Elements>

O arquivo .cs para o manipulador de eventos pode usar o modelo de objeto do SharePoint Foundation para responder a eventos. Para obter informações sobre como usar o modelo de objeto para criar manipuladores de eventos personalizados, consulte Eventos no SharePoint Foundation 2010.

O exemplo a seguir define o conteúdo de uma mensagem de erro a ser exibida quando os 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.";
            }
        }
    }


    Imports System
    Imports System.Collections.Generic
    Imports System.Text
    Imports Microsoft.SharePoint

    Namespace MS.Samples
        Public Class SimpleItemUpdateHandler
            Inherits SPItemEventReceiver
            Public Overrides Sub ItemUpdating(ByVal properties As SPItemEventProperties)
                properties.Status = SPEventReceiverStatus.CancelWithError
                properties.ErrorMessage = "Updating data is not supported."
            End Sub
        End Class
    End Namespace

Confira também

  • Last updated on