Registros de eventos
Registre los controladores de eventos en el sitio o nivel de colección de sitios que se va a usar para implementar el filtrado para responder a los eventos de los elementos de lista.
El elemento Receivers especifica un controlador de eventos para los eventos de elemento de lista.
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
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>
El archivo .cs del controlador de eventos puede usar el modelo de objetos de Windows SharePoint Services para responder a eventos. Para obtener información acerca del uso de este modelo de objetos para crear controladores de eventos personalizados, consulte Fundamentos de eventos.
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.";
}
}
}
Vea también
Otros recursos
Procedimiento para crear una característica de controlador de eventos
Fundamentos de eventos