Skip to main content

Mark Wagner - Cogitation Blog

Go Search
Blog
SPDev
SharePoint
Governance
  

Welcome
Mark Wagner works for Microsoft as a Consultant working in the West Region.
My old blog
Mark Wagner - Cogitation Blog > Posts > SPSecurityTrimmedControl: Conditionally display contents by security
SPSecurityTrimmedControl: Conditionally display contents by security
The SPSecurityTrimmedControl control will conditionally render the contents of this control to the current user only if the current user has access to the permission defined in the PermissionString.  The content can be any HTML code or control you like.  The PermissionString attribute defines the permission required to view the contents.  These Permissions are the same base values that are used in various combinations to the define the default Permission Levels that are created with each new site collection such as Design, Contribute, Read, etc...  You can also create your own custom Permission Levels for use in configuring your SharePoint security.  But remember, the PermissionString attribute can only be supplied valid Permission values, not Permission Levels.  There are 33 base SharePoint Permissions (Permission levels and permissions) of which any of these can be used.
This is a terrific control for use with your custom master pages and even with any custom SharePoint .ASPX pages you are hosting in SharePoint.
 
Attributes:
  • PermissionString: (required)
    Defines the permission values required to render the contents.
  • PermissionContext (optional):
    Enumeration Values:
    - PermissionContext.CurrentFolder
    - PermissionContext.CurrentItem
    - PermissionContext.CurrentList
    - PermissionContext.CurrentSite
    - PermissionContext.RootSite
  • PermissionMode (optional):
    Allows you to define whether All permissions are required or Any permission is required to render contents.
    Enumeration Values:
    - PermissionMode.All
    - PermissionMode.Any
Sample code:

<Sharepoint:SPSecurityTrimmedControl runat="server" PermissionsString="AddAndCustomizePages">

You can place any text or HTMl in this section. Only users having the AddAndCustomizePages permission will see this.

</SharePoint:SPSecurityTrimmedControl>

If you need to, you can even create your own Security Trimmer as shown here.
http://msdn2.microsoft.com/en-us/library/aa981236.aspx

Another method worth noting is the RightsSensitiveVisibilityHelper.UserHasRights method.
https://msdn2.microsoft.com/en-us/library/ms465624.aspx

References:

Comments

Why would SPSecurityTrimmedControl delete part

I'm surrounding a discussion web part with SPSecurityTrimmedControl to control who see the discussion board on my default.aspx page. As soon as I save the page, the code is removed from my aspx document in sharepoint designer.

Any idea what's causing this?
at 6/26/2009 11:09 AM

Same problem with SPSecurityTrimmedControl

I have the same problem with the code being removed from the aspx when saved in SPD.

Any suggestions?
at 7/22/2009 11:11 AM

Very nice site!

Very nice site!
at 8/7/2009 3:23 AM

Add Comment

Items on this list require content approval. Your submission will not appear in public views until approved by someone with proper rights. More information on content approval.

Title


Body *


Today's Date *

Please enter today's date. This will help prevent blog spam. Thank you.
Attachments