Novedades de los controladores de eventos

Muchos programadores usan los controladores de eventos de Windows SharePoint Services para ejecutar código administrado personalizado en bibliotecas de documentos o bibliotecas de formularios. El objetivo de Windows SharePoint Services 3.0 es ofrecer a los programadores una plataforma aún más flexible para desarrollar puntos de integración personalizados y crear nuevos tipos de aplicaciones sobre la base de la infraestructura. Con este fin, se ha ampliado el ámbito y el alcance de los controladores de eventos de Windows SharePoint Services 3.0 en diversos aspectos.

Cambios en los controladores de eventos

Las principales nuevas características incorporadas a los controladores de eventos son:

Mayor ámbito de los eventos

Se ha ampliado el ámbito de eventos para que abarque no sólo bibliotecas de documentos y formularios, sino también listas y algunos eventos de sitios web y colecciones de sitios.

• Los eventos desencadenados por listas permiten enlazar código cuando se agregan, se cambian o se quitan elementos de lista, lo que significa que se puede crear un comportamiento personalizado mediante código administrado de Microsoft .NET .

  Nota

  Para los documentos, las propiedades Before y After están disponibles para el registro de eventos, como ItemUpdated; sin embargo, las propiedades Before no están disponibles para el registro de eventos en elementos de lista.

• Los eventos que se producen cuando un usuario agrega o quita campos de una lista.

• Los eventos que se producen cuando se elimina un sitio web o una colección de sitios.

  Nota

  Windows SharePoint Services admite eventos de eliminación de sitios web de aprovisionamiento a través del modelo de objetos, pero no a través de características personalizadas.

Mayor alcance y flexibilidad de los eventos

El alcance y la flexibilidad de los eventos es también una de las principales nuevas mejoras y, ahora, hay dos tipos principales de eventos:

• Eventos Before: los eventos que se desencadenan antes de que se produzca una acción permiten realizar la comprobación, el procesamiento o la validación personalizada de datos que se van a eliminar, modificar o agregar a una lista. Todos estos tipos de eventos llevan el sufijo "ing" para identificarlos como eventos Before. Tenga en cuenta que el código de reacción frente a estos eventos se ejecuta de forma sincrónica.

• Eventos After: los eventos que se desencadenan después de una determinada acción resultan probablemente familiares para la mayoría de los programadores que trabajan con Windows SharePoint Services 2.0. Estos eventos llevan el sufijo "ed" y el código usado para ellos se ejecuta de forma asincrónica.

Mayor flexibilidad del controlador de eventos

Los controladores de eventos se registran de manera diferente que en Windows SharePoint Services 2.0, en el que era posible adjuntar sólo un ensamblado por biblioteca documentos o formularios. Windows SharePoint Services 3.0 ofrece mayor flexibilidad para controlar y registrar los eventos.

Capacidad para comunicar respuestas a la interfaz de usuario

Con Windows SharePoint Services 3.0, puede comunicar respuestas a la interfaz de usuario. Por ejemplo, imaginemos un escenario en el que un usuario intenta agregar un nuevo elemento y un controlador de eventos invalida esa entrada a causa de alguna regla de negocio. En este caso, puede crear un mensaje de error que se presentará al usuario.

Eventos de creación o eliminación de sitios web

Es posible crear un controlador de eventos para el evento WebDeleting o WebDeleted a fin de que, cuando se elimine un sitio web, primero se realice una copia de seguridad y se guarde en un archivo de almacenamiento para facilitar la recuperación. Para el mecanismo de copia de seguridad, use el método Backup si se elimina el sitio web raíz; de lo contrario, use la clase SPExport.

Para registrar una devolución de llamada que se desencadena cada vez que se crea un nuevo sitio web en una colección de sitios o globalmente en una implementación, puede crear una característica para que la activación de llamadas se produzca cuando se activa la característica. Puesto que las características pueden abarcar un sitio web, la creación de una característica que se active cada vez que se crea un sitio web proporciona un evento de creación de sitio web. Para obtener información acerca de cómo asociar una característica con las definiciones de sitio de un tipo concreto, consulte Asociación de plantillas de característica/sitio.

Vea también

Otros recursos

Introducción a la personalización mediante programación de un sitio web de SharePoint en Visual Studio
Validación de seguridad y realización de envíos para actualizar datos
Concesión de privilegio
Trabajo con características