Eventos Feature

Última modificación: lunes, 27 de diciembre de 2010

Hace referencia a: SharePoint Foundation 2010

Microsoft SharePoint Foundation proporciona clases para responder a los eventos de característica, lo que permite capturar y responder a un evento que se desencadena al instalar una característica en el conjunto o granja de servidores, al agregar una característica a un servidor virtual nuevo o al quitar una característica.

Algunos de estos eventos son post-eventos, lo que significa que se desencadenan después de que se confirmen sus comportamientos respectivos y después de crearse la definición de característica en la colección de definiciones de características para la granja.

No se puede cancelar una operación de instalación o desinstalación mediante eventos de característica.

Clases de eventos de característica

• Microsoft.SharePoint.SPFeatureReceiver   Clase abstracta base que se puede invalidar para implementar las operaciones de activación, desactivación, instalación, desinstalación o actualización de una característica.

• Microsoft.SharePoint.SPFeatureReceiverProperties   Clase que proporciona acceso a propiedades de eventos, como la instancia de característica que se ha creado, para la definición de característica o el objeto primario de la característica.

Controladores de eventos de aprovisionamiento de características

Los controladores de aprovisionamiento de características permiten escribir código específico para controlar varios eventos que ocurren durante el ciclo de vida de una característica. La clase SPFeatureReceiver proporciona los siguientes métodos para controlar los eventos:

• FeatureInstalled(SPFeatureReceiverProperties)

• FeatureUninstalling(SPFeatureReceiverProperties)

• FeatureActivated(SPFeatureReceiverProperties)

• FeatureDeactivating(SPFeatureReceiverProperties)

• FeatureUpgrading(SPFeatureReceiverProperties, String, IDictionary<String, String>)

Para implementar controladores de eventos de aprovisionamiento, cree una clase que derive de SPFeatureReceiver e implementa estos métodos. Siempre se pasa el puntero al objeto primario, por lo que puede personalizarlo según sea necesario. El ensamblado que contiene un receptor de características se debe ubicar en la memoria caché global de ensamblados (GAC). En el archivo Feature.xml, puede registrar un receptor de característica mediante los atributos ReceiverAssembly y ReceiverClass del elemento Feature de primer nivel; por ejemplo:

<Feature Id="5E88AE4E-2ECB-4CC5-B9EC-9019250F5BC8"
  Title="Knowledge Base Infrastructure"
  Scope="Site"
  ReceiverAssembly="MS.Samples.SharePoint.KnowledgeBase, Version=1.0.0.0, Culture=neutral, PublicKeyToken=d24e3c1752ded9ed"
ReceiverClass="MS.Samples.SharePoint.KnowledgeBase.KnowledgeBaseInstaller" 
  xmlns="https://schemas.microsoft.com/sharepoint/">

Las excepciones producidas durante el proceso de activación se comunican al usuario y la característica no se marca como activada.

Escriba código para controlar los casos en que el usuario intenta forzar la activación de la característica aunque ya esté activada. Por ejemplo, si un controlador de eventos del receptor de características crea una lista, compruebe que el código no genera un error si la lista ya existe.