UserCustomActionCollection.Add Method

Adds a new UserCustomAction custom action to the collection.

Namespace:  Microsoft.SharePoint.Client
Assemblies:   Microsoft.SharePoint.Client.Silverlight (in Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client (in Microsoft.SharePoint.Client.dll)


<RemoteAttribute> _
Public Function Add As UserCustomAction
Dim instance As UserCustomActionCollection
Dim returnValue As UserCustomAction

returnValue = instance.Add()
public UserCustomAction Add()

Return Value

Type: Microsoft.SharePoint.Client.UserCustomAction
Returns a UserCustomAction instance representing a new custom action to the collection.


Exception Condition

The current user does not have permissions to perform the operation. Error code: -2147024891.


This code example adds a new menu item to the Site Actions menu of the specified site.

using System;
using Microsoft.SharePoint.Client;

namespace Microsoft.SDK.SharePointFoundation.Samples
    class UserCustomActionCollection_AddExample
        static void Main()
            string siteUrl = "http://MyServer/sites/MySiteCollection";

            ClientContext clientContext = new ClientContext(siteUrl);
            Web site = clientContext.Web;

            UserCustomActionCollection collUCA = site.UserCustomActions;
            UserCustomAction newUCA = collUCA.Add();
            newUCA.Location = "Microsoft.SharePoint.StandardMenu";
            newUCA.Group = "SiteActions";
            newUCA.Sequence = 1000;
            newUCA.Title = "New Menu Item";
            newUCA.ImageUrl = "/_layouts/images/myIcon.jpg";
            newUCA.Description = "Menu item added";
            newUCA.Url = "/_layouts/create.aspx";


            Console.WriteLine("New menu item added to Site Actions menu.\n\nTo view the new menu item, refresh the page.");

See Also


UserCustomActionCollection Class

UserCustomActionCollection Members

Microsoft.SharePoint.Client Namespace