Übersicht über die IPolicyFeature-Schnittstelle
Letzte Änderung: Freitag, 2. April 2010
Gilt für: SharePoint Server 2010
Wenn Sie erstmals eine Informationsverwaltungsrichtlinie auf ein Element anwenden, müssen häufig bestimmte Vorgänge von Richtlinienfeatures zur Initialisierung der Anwendung der Richtlinie des Features auf dieses Element ausgeführt werden. Bei dieser Initialisierung werden ggf. die folgenden Aktionen ausgeführt:
Erstellen einer Spalte in der Liste des Elements. So wird beispielsweise durch das Ablaufrichtlinienfeature eine neue Spalte namens ExpireDate für Elemente erstellt, auf die das Feature angewendet wird.
Registrieren für Ereignisse in der Liste des Elements.
Ausführen einiger Aufgaben für das Element. So wird beispielsweise durch das Ablaufrichtlinienfeature der Anfangswert der ExpireDate-Spalte für Elemente, auf die das Feature angewendet wird, berechnet.
Zusätzlich zur Installation einer gültigen Richtlinienfeaturedefinition muss jedes Richtlinienfeature auch eine Klasse enthalten, die die IPolicyFeature-Schnittstelle implementiert. Diese Schnittstelle ermöglicht es Microsoft SharePoint Server 2010, den Code zur Ausführung aller Initiierungsschritte aufzurufen, die vom Richtlinienfeature benötigt werden. Die Schnittstelle ermöglicht es SharePoint Server 2010 darüber hinaus, den Code für die Ausführung aller Aufgaben aufzurufen, die ausgeführt werden müssen, wenn ein dem Richtlinienfeature zugeordnetes Richtlinienelement hinzugefügt, gelöscht oder für einen Inhaltstyp geändert wird.
Die entsprechende Methode wird von SharePoint Server 2010 aufgerufen, wenn Richtlinienelemente hinzugefügt, gelöscht oder für einen Inhaltstyp geändert werden.
Die IPolicyFeature-Schnittstelle enthält die folgenden Methoden:
-
Aufgerufen von SharePoint Server 2010, wenn ein Benutzer die benutzerdefinierten Einstellungen für ein dem Richtlinienfeature zugeordnetes bestimmtes Richtlinienelement ändert.
-
Aufgerufen von SharePoint Server 2010, wenn ein Benutzer die Einstellungen auf Serverfarmebene für ein Richtlinienfeature ändert.
-
Aufgerufen von SharePoint Server 2010, wenn eine Richtlinie geändert wird. Zu diesen Änderungen gehören die Bearbeitung der derzeit der Liste zugeordneten Richtlinie oder die Zuweisung einer anderen Richtlinie zur Liste.
.gif "Hinweis")
HinweisWird false von einem Richtlinienfeature zurückgegeben, werden die verbleibenden Elemente nicht von SharePoint Server 2010 verarbeitet. Durch diese Optimierung wird verhindert, dass SharePoint Server 2010 alle Elemente in einer Liste für Richtlinienfeatures durchläuft, die nicht an der Verarbeitung des Elements beteiligt sind.
-
Aufgerufen von SharePoint Server 2010 für Listenelemente, die der angegebenen Richtlinie nicht länger unterliegen. Mit dieser Methode können Sie die Aufhebung der Registrierung auf Elementebene angeben, die ausgeführt werden muss, wenn die Richtlinie von einem Element entfernt wird.
-
Aufgerufen von SharePoint Server 2010, wenn ein Benutzer ein neues Richtlinienelement zu einer Richtlinie hinzufügt. Mit dieser Methode werden alle erforderlichen Initiierungsschritte für das Richtlinienfeature durchgeführt, wie beispielsweise das Hinzufügen bestimmter Spalten zum Inhaltstyp oder das Registrieren für Ereignisse.
-
Aufgerufen von SharePoint Server 2010, wenn ein vorhandenes Richtlinienelement aus einer Richtline entfernt wird.
Wenn Sie einer Richtlinie ein Richtlinienelement hinzufügen, wird die Register-Methode des zugeordneten Richtlinienfeatures von SharePoint Server 2010 zur Durchführung der erforderlichen Initiierungsschritte aufgerufen.
Wenn Sie ein Richtlinienelement aus einer Richtlinie entfernen, wird entsprechend die UnRegister-Methode des zugeordneten Richtlinienfeatures von SharePoint Server 2010 zur Durchführung erforderlicher Bereinigungsschritte aufgerufen.
Bei der Änderung einer Richtlinie wird die ProcessListItem-Methode für jedes geänderte Richtlinienfeature von SharePoint Server 2010 aufgerufen. Wenn das Richtlinienfeature nicht geändert wurde, werden keine Methoden von SharePoint Server 2010 aufgerufen.
Angenommen, Ihre Richtlinie für einen bestimmten Inhaltstyp enthält ein Richtlinienfeature (Barcodes), und Sie fügen dann ein Richtlinienelement für das Ablaufrichtlinienfeature hinzu. Die Register-Methode des Ablaufrichtlinienfeatures wird von SharePoint Server 2010 aufgerufen, um das Feature für jedes Element zu initialisieren, das diesem Inhaltstyp zugewiesen ist. Da das Richtlinienelement für das Richtlinienfeature Barcodes in der Richtlinie jedoch nicht geändert wurde, wird die ProcessListItem-Methode dieses Richtlinienfeatures nicht von SharePoint Server 2010 aufgerufen.
Siehe auch
Konzepte
Verwalten von Informationsverwaltungsrichtlinien
Richtlinienfeatures (Übersicht)
Definitionen für das Richtlinienfeature