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.
Elemento Synchronization (Event)
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