SPPolicyCollection-Klasse
Stellt eine Auflistung von SPPolicy -Objekten dar.
Vererbungshierarchie
System.Object
Microsoft.SharePoint.Administration.SPAutoSerializingObject
Microsoft.SharePoint.Administration.SPPolicyCollection
Namespace: Microsoft.SharePoint.Administration
Assembly: Microsoft.SharePoint (in Microsoft.SharePoint.dll)
Syntax
'Declaration
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel := True)> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel := True)> _
Public NotInheritable Class SPPolicyCollection _
Inherits SPAutoSerializingObject _
Implements IEnumerable
'Usage
Dim instance As SPPolicyCollection
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel = true)]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel = true)]
public sealed class SPPolicyCollection : SPAutoSerializingObject,
IEnumerable
Hinweise
Die Richtlinie für eine Zone ist eine Auflistung von Gruppenrichtlinienobjekten. Jeder Benutzer oder die Gruppe wird ein separates Gruppenrichtlinienobjekt zugewiesen.
Verwenden Sie die Policies -Eigenschaft der SPWebApplication -Klasse, um die Auflistung von Richtlinien für eine Webanwendung zurückzugeben, oder verwenden Sie die ZonePolicies -Methode der SPWebApplication -Klasse, um die Auflistung von Richtlinien für eine angegebene Zone zurückzugeben.
Führen Sie zum Erstellen einer Richtlinie die folgenden Schritte aus:
Verwenden Sie die Add -Methode, um ein Richtlinienobjekt innerhalb der Auflistung von Richtlinien für die Webanwendung zu erstellen.
Verwenden Sie die Add -Methode der SPPolicyRoleCollection -Klasse, um ein Richtlinienobjekt für die Rolle in der Auflistung der richtlinienrollen für die Webanwendung zu erstellen.
Verwenden Sie die Add -Methode der SPPolicy.SPPolicyRoleBindingCollection -Klasse, um die neue richtlinienrolle die Auflistung der Richtlinienbindungen für die neue Richtlinie hinzuzufügen.
Rufen Sie die Update -Methode der SPWebApplication -Klasse, damit die Änderungen wirksam werden.
Verwenden Sie eine Indexerstellung, um eine einzelne Richtlinie aus der Auflistung zurückzugeben. Verwenden Sie beispielsweise, wenn die Auflistung einer Variablen mit dem Namen myPolicieszugewiesen ist, myPolicies[index] in c# oder myPolicies(index) in Visual Basic index entweder den Namen oder die Indexnummer der Richtlinie in der Auflistung entspricht.
Beispiele
Das folgende Beispiel erstellt eine neue Richtlinie innerhalb der Auflistung von Richtlinien für eine angegebene Webanwendung fest.
Dim uri = New Uri("http://MyServer")
Dim webApplication As SPWebApplication = SPWebApplication.Lookup(uri)
Dim policyCollection As SPPolicyCollection = webApplication.Policies
Dim policyRoles As SPPolicyRoleCollection = webApplication.PolicyRoles
Dim policy As SPPolicy = policyCollection.Add("UserAlias", "MyPolicy")
Dim policyRole As SPPolicyRole = policyRoles.Add("MyPolicyRole", "My description.", SPBasePermissions.ViewPages Or SPBasePermissions.ViewListItems, SPBasePermissions.AddAndCustomizePages Or SPBasePermissions.AddListItems)
policy.PolicyRoleBindings.Add(policyRole)
webApplication.Update()
System.Uri uri = new Uri("http://MyServer");
SPWebApplication webApplication = SPWebApplication.Lookup(uri);
SPPolicyCollection policyCollection = webApplication.Policies;
SPPolicyRoleCollection policyRoles = webApplication.PolicyRoles;
SPPolicy policy = policyCollection.Add("UserAlias","MyPolicy");
SPPolicyRole policyRole = policyRoles.Add("MyPolicyRole", "My description.", SPBasePermissions.ViewPages | SPBasePermissions.ViewListItems, SPBasePermissions.AddAndCustomizePages | SPBasePermissions.AddListItems);
policy.PolicyRoleBindings.Add(policyRole);
webApplication.Update();
Threadsicherheit
Alle öffentlichen static (Shared in Visual Basic) Member dieses Typs sind threadsicher. Die Threadsicherheit von Instanzmembern ist nicht gewährleistet.