Nuevos eventos en SharePoint Foundation 2010
Última modificación: jueves, 08 de abril de 2010
Hace referencia a: SharePoint Foundation 2010
En este artículo
Nuevos eventos Agregar y Eliminar en listas
Nuevos eventos Agregar en sitios de SharePoint
Nuevos eventos posteriores sincrónicos
Para admitir un rendimiento mejorado y mayor flexibilidad, se han agregado varios eventos nuevos a la plataforma de desarrollo de Microsoft SharePoint Foundation 2010. Para ver un catálogo de todos los eventos de SharePoint Foundation que incluye notaciones sobre cuáles de estos eventos son nuevos en SharePoint Foundation 2010, vea Catálogo de eventos de SharePoint Foundation.
Nuevos eventos Agregar y Eliminar en listas
Se han proporcionado dos nuevos eventos Add para listas de SharePoint, es decir, para objetos SPList:
Los eventos Add toman propiedades que pasan a estar disponibles mediante el uso de SPListEventProperties y se generan cuando se crea una nueva lista.
El evento ListAdding permite que los usuarios cancelen la creación de la lista. Tenga en cuenta, no obstante, que se recomienda no cancelar la creación de una lista cuando se está aprovisionando una plantilla de sitio o definición de sitio. También tenga en cuenta que los eventos ListAdding tienen lugar durante la restauración de un sitio mediante API en el espacio de nombres Microsoft.SharePoint.Deployment.
Al implementar una solución, ahora puede establecer opciones que permitan pasar por alto los eventos que se generan durante este proceso. El evento ListAdding también tiene lugar cuando se restaura una lista después de haberla reciclado. Este comportamiento es coherente con el modo en que trabajan normalmente las listas de SharePoint. SPListEventProperties tiene dos propiedades adicionales, TemplateId y FeatureId, que se pasan como parámetros para que el programador que usa un evento ListAdding pueda determinar qué tipo de lista se está creando.
Además de estos eventos Add, se han agregado también dos eventos Delete a las listas de SharePoint:
Los eventos Delete permiten cancelar una operación de eliminación de lista en cualquier momento de la operación. Cuando se cancela una operación de eliminación, se pasa un mensaje de error a través de la interfaz y se produce una excepción. Tenga en cuenta que los eventos Delete también tienen lugar cuando se recicla una lista (incluso si técnicamente la propia lista no se elimina). Este comportamiento es coherente con el modo en que trabajan normalmente los elementos de lista de SharePoint.
No se generan eventos Delete en objetos con ámbito limitado cuando se eliminan objetos de nivel superior. Por ejemplo, si tiene lugar un evento Delete en el nivel del sitio web, los eventos con ámbito más limitado, como los de eventos de listas individuales, no se generan. Por este motivo, es importante que tenga en cuenta los ámbitos de los eventos cuando codifica los eventos de eliminación. Tenga presente también que, si otra persona elimina una carpeta de listas independiente (por ejemplo, la carpeta de listas dentro de un sitio web), no habrá eventos interceptables y no se generarán los eventos de listas.
Nuevos eventos Agregar en sitios de SharePoint
Otros nuevos eventos proporcionan mayor control y flexibilidad al crear un sitio de SharePoint (una instancia de SPWeb). Tenga en cuenta, no obstante, que la creación de un sitio de SharePoint implica dos pasos distintos. Primero, debe agregar un sitio a la colección de sitios (cree una instancia de SPSite). En este momento, el sitio no es más que una carpeta vacía con un conjunto de propiedades. A continuación, en el segundo paso, debe aprovisionar el sitio (es decir, aplicar una plantilla web) y posteriormente organizar y crear instancias de otros elementos como listas, archivos y otros objetos de contenido en función de la definición de sitio especificada.
Debido a que la mayor parte de la actividad importante tiene lugar durante la fase de aprovisionamiento, estos nuevos eventos relacionados a sitios se asocian con el proceso de adición y aprovisionamiento del sitio:
El evento WebAdding se genera antes de crear un sitio web nuevo, de modo que, si la operación de creación se cancela, no se crea ningún sitio de SharePoint y el proceso de aprovisionamiento no comienza. Puede usar el evento WebAdding para realizar actividades como validación condicional, que permite asegurar que la dirección URL es válida, por ejemplo, o que el usuario que crea un sitio tiene credenciales adecuadas.
El evento WebProvisioned tiene lugar después de que el sitio web está totalmente aprovisionado y el proceso de aprovisionamiento se ha completado. Se puede configurar este evento para operar tanto en modo sincrónico como asincrónico. Use este evento para finalizar las operaciones de desarrollo, por ejemplo, para agregar elementos web al sitio.
Nuevos eventos posteriores sincrónicos
Los eventos after sincrónicos están diseñados para satisfacer las necesidades que los eventos asincrónicos solo satisfacen parcialmente, es decir, la capacidad para actuar sobre un elemento de lista después de que se haya enviado a la base de datos de contenido, pero antes de que el usuario lo vea realmente. Cuando los eventos after sincrónicos tienen lugar, el evento se procesa antes de que el controlador de eventos renuncie al control.
Nota
El comportamiento de sincronización predeterminado es sincrónico para los eventos before y asincrónico para los eventos after.
También hay una nueva propiedad disponible en la clase base SPEventReceiverDefinition denominada Synchronization. Esta propiedad tiene los métodos get y set para recuperar y establecer el valor de enumeración SPEventReceiverSynchronization. Esta enumeración proporciona un valor llamado Default para admitir la compatibilidad con versiones anteriores.
Vea también
Conceptos
Mejoras en el modelo de eventos para SharePoint Foundation 2010