Introducción a la interfaz IPolicyFeature
Última modificación: viernes, 02 de abril de 2010
Hace referencia a: SharePoint Server 2010
Cuando se aplica inicialmente una directiva de administración de información a un elemento, las características de la directiva a menudo debe realizar ciertas operaciones para inicializar el cumplimiento de la directiva de la característica en ese elemento. Esta inicialización puede incluir las siguientes acciones:
La creación de una columna en la lista del elemento. Por ejemplo, la característica de directiva de caducidad crea una nueva columna, llamada ExpireDate, en los elementos en los que se aplica.
Registro para eventos en la lista del elemento.
Realización de algún tipo de trabajo en el elemento. Por ejemplo, la característica de directiva de caducidad calcula el valor inicial de la columna ExpireDate en los elementos en los que se aplica.
Además de instalar una definición de característica de directiva válida, cada característica de directiva debe contener también una clase que implemente la interfaz IPolicyFeature. Esta interfaz permite que Microsoft SharePoint Server 2010 llame al código para realizar cualquier trabajo de inicio necesario para la característica de la directiva, así como que llame al código para realizar las tareas necesarias cuando un elemento de directiva asociado a la característica de la directiva se agrega, elimina o modifica para un tipo de contenido.
SharePoint Server 2010 llama al método apropiado cuando se agregan, eliminan o modifican elementos de la directiva para un tipo de contenido.
La interfaz IPolicyFeature contiene los siguientes métodos:
-
Llamado por SharePoint Server 2010 cuando un usuario cambia la configuración personalizada en un elemento específico de la directiva asociado con la característica de la directiva.
-
Llamado por SharePoint Server 2010 cuando un usuario modifica la configuración a nivel de granja de servidores para una característica de la directiva.
-
Llamado por SharePoint Server 2010 cuando cambia una directiva. Los cambios incluyen la edición de la directiva actualmente asignada a la lista o la asignación de una directiva diferente a la lista.
Nota
Si se devuelve una directiva como false, SharePoint Server 2010 no procesa el resto de elementos. Esta optimización evita que SharePoint Server 2010 repita todos los elementos en una lista para las características de directiva que no participan en el procesamiento del elemento.
-
Llamado por SharePoint Server 2010 en el caso de elementos de la lista que ya no estén sujetos a la directiva especificada. Este método permite especificar la anulación del registro en nivel de elemento que se debe realizar cuando la directiva se elimina de un elemento.
-
Llamado por SharePoint Server 2010 cuando un usuario agrega un nuevo elemento de directiva a una directiva. Este método realiza cualquier trabajo de inicio necesario para esa característica de directiva, como agregar columnas específicas al tipo de contenido o registrarse para eventos.
-
Llamado por SharePoint Server 2010 cuando se elimina de una directiva un elemento de directiva existente.
Cuando agrega un elemento de directiva a una directiva, SharePoint Server 2010 llama al método Register de la característica de directiva asociada para realizar cualquier trabajo de inicio requerido.
De la misma forma, si elimina un elemento de directiva de una directiva, SharePoint Server 2010 llama al método UnRegister de la característica de directiva asociada para realizar cualquier trabajo de limpieza requerido.
Cuando una directiva cambia, SharePoint Server 2010 llama al método ProcessListItem para cada una de las características de la directiva que ha cambiado. Si la característica de la directiva no ha cambiado, SharePoint Server 2010 no llama a ningún método.
Por ejemplo, supongamos que la directiva para un tipo de contenido determinado contiene una característica de directiva, Códigos de barra, y se le agrega un elemento de directiva para la característica de directiva de caducidad. SharePoint Server 2010 llama al método Register de la característica de la directiva de caducidad para inicializar la característica en cada elemento asignado a ese tipo de contenido. Sin embargo, como el elemento de directiva para la característica de directiva Códigos de barra no ha cambiado dentro de la directiva, SharePoint Server 2010 no llama al método ProcessListItem de esa característica de directiva.
Vea también
Conceptos
Administración de la directiva de administración de la información
Introducción a las características de directiva
Definiciones de características de directiva