Create GroupUserAdded Event Receiver in SharePoint 2013

In this article you will see how to create a GroupUserAdded event receiver in SharePoint 2013.

Introduction

An event receiver is custom code to be called when a triggering action such as adding, updating, deleting, moving, checking in, and checking out occurs on a specified SharePoint object such as site collections, sites, lists, and workflows. SharePoint 2013 introduced a new event receiver class called SPSecurityEventReceiver. The custom event receiver class must derive from SPSecurityEventReceiver (please refer to: http://msdn.microsoft.com/en-us/library/microsoft.sharepoint.spsecurityeventreceiver.roleassignmentadded.aspx).  In this article we will see how to create a group user added event receiver in SharePoint 2013. I have created a custom list called "Group Details" when a user is added to a group, a new item will be created in "Group Details" that will specify the user name and to which group the user is added.

Create the Project

Use the following procedure to create an empty SharePoint Project:

1. Open Visual Studio 2012 (Run as administrator).
2. Go to "File" => "New" => "Project...".
3. Select "SharePoint 2013 Project" template from the installed templates.
4. Enter the Name as "GroupUserAddedEventReceiver" and then click on "Ok".
   
   
   
   Figure 1: New Project template
    
5. Select the site and security level for debugging.
   
   
   
   Figure 2: Specify the site and security level for debugging
   
   
6. Click on Finish.

Add Feature to the project

Use the following procedure to add the group user added feature::

1. In the Solution Explorer, right-click on the Features folder.
2. Click on "Add Feature".
3. Rename the Feature1 to "GroupUserAddedFeature".
4. Double-click on GroupUserAddedFeature and specify the Title & Description.

Figure 3: GroupUserAddedFeature

Add Event Receiver to the Feature

Feature Events receivers are methods that execute when one of the following feature related events occur in SharePoint:

• A feature is installed
• A feature is activated
• A feature is deactivated
• A feature is removed

Please refer to http://msdn.microsoft.com/en-us/library/ee231604.aspx to "Add Feature Event Receivers". On feature activated, please use members of the SPEventReceiverDefinition class to register a GroupUserAdded event receiver.

1. In the Solution Explorer, right-click on "GroupUserAddedFeature".
2. Click on "Add Event Receiver".
3. Double-click on "GroupUserAddedFeature.EventReceiver.cs".
4. Replace the code with the following:

using System;
using System.Reflection;
using System.Runtime.InteropServices;
using System.Security.Permissions;
using Microsoft.SharePoint;

namespace GroupUserAddedEventReceiver.Features.GroupUserAddedFeature
{
    /// <summary>
    /// This class handles events raised during feature activation, deactivation, installation, uninstallation, and upgrade.
    /// </summary>
    /// <remarks>
    /// The GUID attached to this class may be used during packaging and should not be modified.
    /// </remarks>

    [Guid("397207d7-d73d-4cb0-bce9-0753b6185444")]
    public class GroupUserAddedFeatureEventReceiver : SPFeatureReceiver
    {
        public override void FeatureActivated(SPFeatureReceiverProperties properties)
        {
            SPWeb web = properties.Feature.Parent as SPWeb;
            //Adding the GroupUserAdded event
            SPEventReceiverDefinition grpUserAdded = web.EventReceivers.Add();
            grpUserAdded.Name = "Event Receiver GroupUserAdded";
            grpUserAdded.Type = SPEventReceiverType.GroupUserAdded;
            grpUserAdded.Assembly = Assembly.GetExecutingAssembly().FullName;
            grpUserAdded.Class = "GroupUserAddedEventReceiver.GroupUserAddedEvent";
            grpUserAdded.Update();
            web.Update();
        }
    }
}

Add a custom event receiver class

Use the following procedure to add a custom event receiver class:

1. In the Solution Explorer, right-click on the project and click on "Add".

2. Click on "New Item".

3. Select the "Class" template from the installed templates.

4. Enter the name and click on "Add".
   
   
   Figure 4: Add new item

5. Replace "GroupUserAddedEvent.cs" with the following code:
   
   using System;
   using System.Collections.Generic;
   using System.Linq;
   using System.Text;
   using System.Threading.Tasks;
   using Microsoft.SharePoint;

   namespace GroupUserAddedEventReceiver
   {
       class GroupUserAddedEvent:SPSecurityEventReceiver
       {
            publicoverridevoid GroupUserAdded(SPSecurityEventProperties properties)
           {
               base.GroupUserAdded(properties);

               // Get the added user details
               SPUser userAdded = properties.Web.AllUsers.GetByID(properties.GroupUserId);

               // Get the group details to which the user is added
               SPGroup groupAdded = properties.Web.Groups.GetByID(properties.GroupId);

               // Get the group details list
               SPList list = properties.Web.Lists.TryGetList("Group Details");

               // Check if the list exists
               if (list != null)
               {
                   // Add a new item
                   SPListItem item = list.Items.Add();
                   // update the title column
                   item["Title"] = "User: " + userAdded.Name + " added  to the group - " + groupAdded.Name;
                   // Update the item
                   item.Update();
                   // Update the list
                   list.Update();
               }
           }
       }
   } 
    

6. Solution Explorer looks like the following:
   
   

Figure 5: Solution Explorer

Deploy and test the solution

Use the following procedure to deploy and test the solution:

1. Right-click on the solution and click on "Deploy".

2. Navigate to the SharePoint site.

3. Click on "Site Settings".
   
   
   
   Figure 6: Site Settings

4. Click on "People and groups" which is available under the "Users and Permissions" section.
   
   
   
   Figure 7: People and groups

5. Click on "My Custom Group" in the Quick Launch Bar.

6. Click on "New".
   
   
   
   Figure 8: Add user to the group

7. Enter the user name and click on "Share".
   
   
   Figure 9: Add user to the group

8. The user is added to the group.

9. Click on "Group Details" in the Quick Launch Bar.

10. A new item is created as shown in Figure 10.
    
    
    
    Figure 10: A new item created in Group Details list

Summary

Thus in this article you have seen how to create a group user added event receiver in SharePoint 2013.