Compartir a través de


Registros de eventos

Última modificación: miércoles, 24 de marzo de 2010

Hace referencia a: SharePoint Foundation 2010

Registre los controladores de eventos en el nivel del sitio o de la colección de sitios que se va a usar para implementar el filtrado para responder a los eventos.

El elemento Receivers especifica un controlador de eventos para los eventos de elemento de lista.

Elements

  Receivers

    Receiver

      Assembly

      Class

    Data

      Elemento Filter (Event)

      Name

      SequenceNumber

      Elemento SolutionId (Event)

      Elemento Synchronization (Event)

      Type

Ejemplo

Para registrar un controlador de eventos para eventos de lista, cree una carpeta en \Template\Features para que contenga un archivo Feature.xml que especifique el ámbito y el identificador de la característica, así como un archivo de manifiesto de elementos al que hace referencia el archivo anterior.

El archivo Feature.xml que registra un controlador de eventos puede ser similar al siguiente.

<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>

El archivo de manifiesto de elementos registra el ensamblado del controlador de eventos y lo asocia a un tipo de lista, que en el siguiente ejemplo se especifica como las listas de anuncio (104).

<Elements xmlns="https://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>

El archivo .cs del controlador de eventos puede usar el modelo de objetos de SharePoint Foundation para responder a eventos. Para obtener información acerca del uso de este modelo de objetos para crear controladores de eventos personalizados, consulte Eventos de SharePoint Foundation 2010.

El ejemplo siguiente define el contenido de un mensaje de error que se mostrará cuando los usuarios intenten modificar elementos en una 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

Vea también

Tareas

Procedimiento para crear una característica de controlador de eventos

Otros recursos

Eventos de SharePoint Foundation 2010