Richtlinienressource (Übersicht)
Letzte Änderung: Freitag, 2. April 2010
Gilt für: SharePoint Server 2010
Inhalt dieses Artikels
Angeben des globalen Steuerelements für benutzerdefinierte Einstellungen
Angeben des Steuerelements für benutzerdefinierte Einstellungen
Angeben des Assembly- und Klassennamens
Hinzufügen einer Richtlinienressource
Jedes Richtlinienfeature weist eine eigene Ressourcendefinitionsliste auf, in der die verfügbaren Richtlinienressourcen aufgelistet werden.
Damit eine Richtlinienressource für die Verwendung durch ein Richtlinienfeature verfügbar ist, muss die Richtlinienressource eine Richtlinienressourcendefinition für die Richtlinienressourcen-Definitionsliste dieses Richtlinienfeatures installieren. Mit diesem XML-Dokument kann Microsoft SharePoint Server 2010 die Konfiguration der Richtlinienressource in die Verwaltungsoberfläche von SharePoint Server 2010 einbeziehen.
Wie bei der Richtlinienfeaturedefinition kann die Richtlinienressourcendefinition die URLs von zwei Websteuerelementen enthalten:
Ein Websteuerelement, mit dem Administratoren Einstellungen für Richtlinienressourcen auf Serverfarmebene anpassen können
Ein Websteuerelement für Einstellungen für Richtlinienressourcen auf Richtlinieninstanzebene
Angeben des globalen Steuerelements für benutzerdefinierte Einstellungen
Nur das Websteuerelement auf Serverfarmebene, für globale Einstellungen, wird auf den Verwaltungsseiten gehostet. Diese Einstellungen werden in der Richtlinienressourcendefinition gespeichert.
Das Websteuerelement auf Serverfarmebene muss die GlobalCustomSettingsControl-Klasse implementieren.
Wenn Sie kein globales Steuerelement für benutzerdefinierte Einstellungen angeben, können Administratoren die für die Richtlinienressource angegebenen standardmäßigen globalen Daten nicht überschreiben oder bearbeiten und folglich das Ressourcenfeature nicht auf der Administratorebene anpassen.
Angeben des Steuerelements für benutzerdefinierte Einstellungen
Der Benutzer kann eine Richtlinienressource nicht direkt auf der Richtlinienelementebene anpassen, weshalb das Websteuerelement auf Richtlinieninstanzebene nicht von SharePoint Server 2010 gehostet wird. Dieses Steuerelement wird jedoch möglicherweise vom Websteuerelement für das Richtlinienfeature gehostet. Wenn die Richtlinienressource ein Steuerelement auf Richtlinienebene angibt, kann dieses Steuerelement beliebige erforderliche Klassen oder Schnittstellen implementieren, falls das Richtlinienfeature mit dem Steuerelement kommunizieren kann.
Angeben des Assembly- und Klassennamens
Die Richtlinienressourcendefinition enthält zwei weitere Zeiger:
Einen Zeiger auf den Speicherort der Richtlinienressourcen-Assembly im globalen Assemblycache
Einen Zeiger auf die Klasse innerhalb dieser Assembly, mit der die Schnittstelle implementiert wird, die das zugehörige Richtlinienfeature für die Kommunikation mit der Ressource benötigt
Die Richtlinienressource wird von SharePoint Server 2010 nicht direkt aufgerufen, weshalb die Ressource keine bestimmte Schnittstelle implementieren muss, wenn das zugehörige Richtlinienfeature die von der Richtlinienressource implementierten Schnittstellen kennt. Die Ressourcenassembly muss einen starken Namen haben und im globalen Assemblycache gespeichert sein.
In Abbildung 1 sind die in der Richtlinienressourcendefinition enthaltenen Informationen sowie die Elemente, auf die diese Informationen verweisen, dargestellt.
Abbildung 1. Konzeptionelle Struktur der Richtlinienressourcendefinition
.gif "Konzeptionelle Struktur der Richtlinienressourcendefinition")
Hinzufügen einer Richtlinienressource
Jede Richtlinienressourcen-Definitionsliste eines Richtlinienfeatures enthält die Richtlinienressourcendefinitionen für jede Richtlinienressource, die zur Verwendung durch dieses Richtlinienfeature zur Verfügung steht.
Verwenden Sie die Add-Methode der PolicyResourceCollection-Klasse, um der Ressourcenliste eines Richtlinienfeatures eine Richtlinienressource hinzuzufügen. Übergeben Sie das XML der Richtlinienressourcendefinition als Argument.
Dies geschieht in der Regel bei der Bereitstellung der Richtlinienressource als SharePoint Foundation-Feature. Weitere Informationen finden Sie unter Verwenden von Features.
Nachdem Sie der Richtlinienressourcen-Definitionsliste eine Richtlinienressourcendefinition hinzugefügt haben, können Sie die Richtlinienressource programmgesteuert als PolicyResource-Objekt im Objektmodell verwenden.
Siehe auch
Konzepte
Verwalten von Informationsverwaltungsrichtlinien