Cómo: Crear un receptor de eventos

Los receptores de eventos son clases que permiten responder a los eventos que se producen en los elementos de SharePoint, como las listas o los elementos de lista. Cuando alguien cambia el calendario o elimina un nombre de la lista de contactos, se activa el código en el receptor de eventos.

En este procedimiento se muestran las tareas siguientes:

• Agregar un receptor de eventos a una instancia de lista.

Necesita los componentes siguientes para completar estos pasos:

• Ediciones compatibles de Microsoft Windows y SharePoint. Para obtener más información, vea Requisitos para desarrollar soluciones de SharePoint.

• Visual Studio 2010.

También debe completar el procedimiento del tema Tutorial: Crear un campo, tipo de contenido, definición de lista e instancia de lista personalizados.

Agregar un controlador de eventos

El proyecto que creó en Tutorial: Crear un campo, tipo de contenido, definición de lista e instancia de lista personalizados incluye un campo personalizado, una definición de lista personalizada con una instancia de esa lista y un tipo de contenido. A continuación agregará un receptor de eventos a ese proyecto. En el procedimiento siguiente se agrega un controlador de eventos simple (un receptor de eventos) a la instancia de la lista.

Para agregar un receptor de eventos a la instancia de la lista

1. Abra el proyecto que creó en Tutorial: Crear un campo, tipo de contenido, definición de lista e instancia de lista personalizados.

2. Agréguele un receptor de eventos. Para hacerlo, haga clic en el nodo del proyecto en el Explorador de soluciones y en el menú Proyecto, seleccione Agregar nuevo elemento.

3. Expanda el nodo SharePoint bajo Visual C# o bajo Visual Basic y, a continuación, haga clic en 2010.

4. En el recuadro Plantillas, seleccione Receptor de eventos y denomínelo TestEventReceiver1.

   Aparece el Asistente para la personalización de SharePoint.

5. En la página Elegir receptores de eventos, seleccione Eventos de elementos de lista como tipo de receptor de eventos.

6. Establezca el Elemento origen del evento en CampoPersonalizado1 - ListDefinition1.

7. En la lista de eventos para controlar, active la casilla situada junto a Se agregó un elemento y, a continuación, haga clic en Finalizar.

8. El nuevo archivo de código del receptor de eventos contiene un método único denominado ItemAdded. Agregue el código a este método para que cada vez que se agregue un contacto a la lista de contactos, se use Scott Brown como valor predeterminado de Patient Name. Para ello, reemplace el método ItemAdded por el código siguiente:

   Public Overrides Sub ItemAdded(ByVal properties As SPItemEventProperties)
       properties.ListItem("Patient Name") = "Scott Brown"
       properties.ListItem.Update()
       MyBase.ItemAdded(properties)
   End Sub
   

   public override void ItemAdded(SPItemEventProperties properties)
   {
       properties.ListItem["Patient Name"] = "Scott Brown";
       properties.ListItem.Update();
       base.ItemAdded(properties);
   }
   

9. Presione F5 para ejecutar el código y ver el sitio de SharePoint en el explorador web.

10. En la barra de inicio rápido, haga clic en CampoPersonalizado1 - InstanciaLista1.

    Esta es la instancia de la lista para la definición de lista. Observe que el campo Patient Name no aparece todavía como una columna en la instancia de la lista.

11. Haga clic en Lista en la pestaña Herramientas de lista en la parte superior de la página y, a continuación, haga clic en el botón Modificar esta vista en la cinta de opciones.

12. En la lista de nombres de columna disponibles, seleccione Patient Name y, a continuación, haga clic en Aceptar. Observe que el campo Patient Name aparece ahora en la instancia de la lista.

13. En la pestaña Herramientas de lista de la parte superior de la página, haga clic en Elementos y, a continuación, en el botón Nuevo elemento para mostrar el formulario de entrada de datos.

14. Escriba los datos en los campos y, a continuación, haga clic en el botón Guardar en el nuevo cuadro de diálogo de elemento de la instancia de la lista.

    La columna Patient Name se rellenará automáticamente con Scott Brown cuando haga clic en Aceptar.

Vea también

Otros recursos

Desarrollar soluciones de SharePoint