Bloque de creación: control de eventos
Última modificación: miércoles, 07 de abril de 2010
Hace referencia a: SharePoint Foundation 2010
Los objetos principales del modelo de objetos de SharePoint Foundation proporcionan clases base del receptor de eventos desde las cuales se debe derivar al escribir controladores de eventos. Por ejemplo, el objeto SPWeb tiene un tipo SPWebEventReceiver correspondiente, el objeto SPList tiene un tipo SPListEventReceiver, etc. Los tipos de receptor de eventos no se deben implementar directamente, sino que se deben heredar desde la clase del receptor adecuada y, posteriormente, se debe implementar la clase derivada. Tenga en cuenta que todas las clases del receptor de eventos de SharePoint heredan desde una sola clase base del receptor de eventos, que es SPEventReceiverBase.
Una vez escritos, los receptores de eventos de SharePoint Foundation se compilan en ensamblados del receptor de eventos y se implementan en la memoria caché global de ensamblados (GAC). Los receptores de eventos también deben registrarse en el ámbito para el cual controlan eventos.
Modelo de objetos para eventos
Los tipos de controlador de eventos no se ubican en un espacio de nombres del controlador de eventos, sino en el mismo espacio de nombres que sus objetos de SharePoint asociados. Por ejemplo, todos los objetos de SharePoint de primer nivel (SPWeb, SPSite, SPList, etc.) se ubican en el espacio de nombres Microsoft.SharePoint junto con sus tipos de receptor de eventos asociados. Tenga en cuenta que la convención de nomenclatura para los tipos de receptor de eventos sigue el patrón conocido descrito más arriba, es decir, <nombre de objeto> con el término "EventReceiver" agregado como sufijo. De este modo, los tipos de receptor de eventos como SPWorkflowEventReceiver y StyleLibraryEventReceiver son fáciles de identificar y comprender.
.gif "Nota de precaución") Precaución |
|---|
Hay algunas excepciones para la regla de nomenclatura del receptor de eventos. Por ejemplo, el receptor de eventos para características de SharePoint se denomina SPFeatureReceiver, en lugar de SPFeatureEventReceiver como podría esperarse. |
Los tipos de receptor de eventos también se asocian con contenedores de propiedades de eventos que proporcionan acceso a diversas propiedades de un evento especificado. Los contenedores de propiedades de eventos generalmente se denominan <nombre de objeto> con el término "EventProperties" agregado como sufijo. Los contenedores de propiedades de eventos típicos son SPWebEventProperties, SPListEventProperties, etc.