Share via

para crear un receptor de eventos

  • Artículo

Mediante la creación de receptores de eventos, puede responder cuando un usuario interactúa con elementos de SharePoint, como listas o elementos de lista. Por ejemplo, el código de un receptor de eventos se puede desencadenar cuando un usuario cambia el calendario o elimina un nombre de una lista de contactos. Si sigue este tema, puede aprender a agregar un receptor de eventos a una instancia de lista.

Para realizar estos pasos, debe haber instalado Visual Studio y las ediciones compatibles de Windows y SharePoint. Dado que este ejemplo requiere un proyecto de SharePoint, también debe haber completado el procedimiento en el tema Tutorial: Creación de una columna, un tipo de contenido y una lista de sitios para SharePoint.

Incorporación de un receptor de eventos

El proyecto que creó en Tutorial: Creación de una columna, un tipo de contenido y una lista de sitios para SharePoint incluye columnas de sitio personalizadas, una lista personalizada y un tipo de contenido. En el procedimiento siguiente, expandirá este proyecto mediante la adición de un controlador de eventos simple (un receptor de eventos) a una instancia de lista para mostrar cómo controlar los eventos que se producen en elementos de SharePoint como, por ejemplo, listas.

Para agregar un receptor de eventos a la instancia de lista

  1. Abra el proyecto que creó en Tutorial: Creación de una lista, tipo de contenido y columna de sitio para SharePoint.

  2. En el Explorador de soluciones, elija el nodo de proyecto de SharePoint, que se llama Clínica.

  3. En la barra de menús, elija Proyecto>Agregar nuevo elemento.

  4. En Visual C# o Visual Basic, expanda el nodo de SharePoint y, a continuación, elija el elemento 2010.

  5. En el panel Plantillas, elija Receptor de eventos, asígnele el nombre TestEventReceiver1 y, a continuación, seleccione el botón Aceptar.

    Aparecerá el Asistente para la personalización de SharePoint.

  6. En la lista ¿Qué tipo de receptor de eventos desea usar?, elija Eventos de elementos de lista.

  7. En la lista ¿Qué elemento debe ser el origen del evento?, elija Pacientes (Clínica\Pacientes).

  8. En la lista Controlar los siguientes eventos, active la casilla situada junto a Se agregó un elemento y, a continuación, seleccione el botón Finalizar.

    El archivo de código del nuevo receptor de eventos contiene un único método denominado ItemAdded. En el paso siguiente, agregará código a este método para que cada contacto reciba el nombre de Scott Brown de forma predeterminada.

  9. Reemplace el método ItemAdded existente por el código siguiente y, a continuación, pulse la tecla F5:

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

    El código se ejecuta y el sitio de SharePoint aparece en el explorador web.

  10. En la barra Inicio rápido, elija el vínculo Pacientes y el vínculo Agregar nuevo elemento.

    Se abre el formulario de entrada para nuevos elementos.

  11. Escriba datos en los campos y, a continuación, elija el botón Guardar.

    Después de elegir el botón Guardar, la columna Nombre del paciente se actualiza automáticamente con el nombre de Scott Brown.

Contenido relacionado