Partager via


UserCustomActionCollection.Add - Méthode

Ajoute une nouvelle action personnalisée UserCustomAction à la collection.

Espace de noms :  Microsoft.SharePoint.Client
Assemblys :   Microsoft.SharePoint.Client.Silverlight (dans Microsoft.SharePoint.Client.Silverlight.dll);  Microsoft.SharePoint.Client.Phone (dans Microsoft.SharePoint.Client.Phone.dll)  Microsoft.SharePoint.Client (dans Microsoft.SharePoint.Client.dll)

Syntaxe

'Déclaration
Public Function Add As UserCustomAction
'Utilisation
Dim instance As UserCustomActionCollection
Dim returnValue As UserCustomAction

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

Valeur renvoyée

Type : Microsoft.SharePoint.Client.UserCustomAction
Retourne une instance de UserCustomAction qui représente une nouvelle action personnalisée à la collection.

Exceptions

Exception Condition
UnauthorizedAccessException

L'utilisateur actuel ne dispose pas d'autorisations pour effectuer cette opération. Code d'erreur : -2147024891.

Exemples

Cet exemple de code ajoute un nouvel élément de menu dans le menu Actions du Site du site spécifié.

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";
            newUCA.Update();

            clientContext.ExecuteQuery();

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

Voir aussi

Référence

UserCustomActionCollection classe

UserCustomActionCollection - Membres

Microsoft.SharePoint.Client - Espace de noms