Obsolete.
Use the new
SPRoleDefinition and
SPRoleAssignment classes instead, to define roles and to assign users to them. For more information, see
Changes in the Authorization Object Model. (In Windows SharePoint Services 2.0,
SPRole represented the permission assigned to a user or group for a list or a site and is maintained for backward compatibility.)
Namespace: Microsoft.SharePoint
Assembly: Microsoft.SharePoint (in microsoft.sharepoint.dll)
Syntax
Visual Basic (Declaration)
<ObsoleteAttribute("Use the SPRoleAssignment class instead")> _
<SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel:=True)> _
<SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel:=True)> _
Public Class SPPermission
Dim instance As SPPermission
[ObsoleteAttribute("Use the SPRoleAssignment class instead")]
[SharePointPermissionAttribute(SecurityAction.LinkDemand, ObjectModel=true)]
[SharePointPermissionAttribute(SecurityAction.InheritanceDemand, ObjectModel=true)]
public class SPPermission
Remarks
Use the Permissions property of either the SPList or SPWeb class to return an SPPermissionCollection object that represents the collection of permissions for a list or a site. Use an indexer to return a single permission from the collection. For example, if the collection is assigned to a variable named collPermissions, use collPermissions[index] in C#, or collPermissions(index) in Visual Basic, where index is either the index number of the permission in the collection or the SPMember object for a user or group that has the permission for the list or site.
A permission consists of a right or combination of rights as specified by the SPRights enumeration. The PermissionMask property contains the set of rights assigned to the user or group.
Example
The following code example uses the PermissionMask property of the SPPermission class to modify the permissions assigned to a single user.
Dim siteCollection As SPSite = SPContext.Current.Site
Dim site As SPWeb = siteCollection.AllWebs("Site_Name")
Dim list As SPList = site.Lists("List_Name")
Dim perms As SPPermissionCollection = list.Permissions
Dim users As SPUserCollection = site.Users
Dim member As SPMember = users("User_Name")
list.Permissions(member).PermissionMask =
SPRights.AddListItems Or SPRights.EditListItems
SPSite oSiteCollection = SPContext.Current.Site;
using(SPWeb oWebsite = oSiteCollection.AllWebs["Site_Name"])
{
SPList oList = oWebsite.Lists["List_Name"];
SPPermissionCollection collPermissions = oList.Permissions;
SPUserCollection collUsers = oWebsite.Users;
SPMember oMember = collUsers["User_Name"];
oList.Permissions[oMember].PermissionMask =
SPRights.AddListItems | SPRights.EditListItems;
}
Inheritance Hierarchy
Thread Safety
Any public static (
Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
See Also