如何:向 SharePoint 项目中添加快捷菜单项

可以向任何 SharePoint 项目中添加快捷菜单项。 当用户在**“解决方案资源管理器”**中右击某个项目节点时,将出现该菜单项。

下面的步骤假定您已创建了一个项目扩展。 有关更多信息,请参见如何:创建 SharePoint 项目扩展

向 SharePoint 项目中添加快捷菜单项

  1. ISharePointProjectExtension 实现的 Initialize 方法中,处理 projectService 参数的 ProjectMenuItemsRequested 事件。

  2. ProjectMenuItemsRequested 事件的事件处理程序中,将新的 IMenuItem 对象添加到事件实参参数的 ActionMenuItemsAddMenuItems 集合中。

  3. 在新的 IMenuItem 对象的 Click 事件处理程序中,执行您希望在用户单击快捷菜单项时执行的任务。

示例

下面的代码示例演示如何向**“解决方案资源管理器”中的 SharePoint 项目节点添加快捷菜单项。 当用户右击项目节点并单击“Write Message to Output Window”(向输出窗口写入消息)**菜单项时,Visual Studio 将在 **“输出”**窗口中显示一条消息。 此示例使用 SharePoint 项目服务来显示消息。 有关更多信息,请参见使用 SharePoint 项目服务

Imports System
Imports System.ComponentModel.Composition
Imports Microsoft.VisualStudio.SharePoint

Namespace Contoso.Examples

    <Export(GetType(ISharePointProjectExtension))> _
    Friend Class ExampleProjectExtensionWithMenu
        Implements ISharePointProjectExtension

        Private Sub Initialize(ByVal projectService As ISharePointProjectService) _
            Implements ISharePointProjectExtension.Initialize
            AddHandler projectService.ProjectMenuItemsRequested, AddressOf ProjectMenuItemsRequested
        End Sub

        Private Sub ProjectMenuItemsRequested(ByVal Sender As Object,
            ByVal e As SharePointProjectMenuItemsRequestedEventArgs)
            Dim menuItem As IMenuItem = e.ActionMenuItems.Add("Write Message to Output Window")
            AddHandler menuItem.Click, AddressOf MenuItem_Click
        End Sub

        Private Sub MenuItem_Click(ByVal Sender As Object, ByVal e As MenuItemEventArgs)
            Dim project As ISharePointProject = TryCast(e.Owner, ISharePointProject)
            If project IsNot Nothing Then
                project.ProjectService.Logger.WriteLine(
                    String.Format("This message was written from a shortcut menu for the {0} project.", project.Name),
                    LogCategory.Status)
            End If
        End Sub
    End Class
End Namespace
using System;
using System.ComponentModel.Composition;
using Microsoft.VisualStudio.SharePoint;

namespace Contoso.Examples
{
    [Export(typeof(ISharePointProjectExtension))]
    internal class ExampleProjectExtensionWithMenu : ISharePointProjectExtension
    {
        public void Initialize(ISharePointProjectService projectService)
        {
            projectService.ProjectMenuItemsRequested += projectService_ProjectMenuItemsRequested;
        }

        void projectService_ProjectMenuItemsRequested(object sender, 
            SharePointProjectMenuItemsRequestedEventArgs e)
        {
            IMenuItem menuItem = e.ActionMenuItems.Add("Write Message to Output Window");
            menuItem.Click += MenuItemExtension_Click;
        }

        void MenuItemExtension_Click(object sender, MenuItemEventArgs e)
        {
            ISharePointProject project = e.Owner as ISharePointProject;
            if (project != null)
            {
                project.ProjectService.Logger.WriteLine(
                    String.Format("This message was written from a shortcut menu for the {0} project.", project.Name),
                    LogCategory.Status);
            }
        }
    }
}

编译代码

此示例需要引用了下列程序集的类库项目:

  • Microsoft.VisualStudio.SharePoint

  • System.ComponentModel.Composition

部署扩展

若要部署扩展,请为要随此扩展分发的程序集和任何其他文件创建 Visual Studio 扩展 (VSIX) 包。 有关更多信息,请参见在 Visual Studio 中部署 SharePoint 工具扩展

请参见

任务

如何:创建 SharePoint 项目扩展

其他资源

扩展 SharePoint 项目

如何:向 SharePoint 项目中添加属性