通过

演练：向服务器功能区中添加按钮

  • 项目

上次修改时间： 2011年2月7日

适用范围： SharePoint Foundation 2010

本文内容
创建 SharePoint 项目
添加新功能
定义自定义操作
部署自定义项

本主题介绍如何在 Microsoft SharePoint Foundation 中将新按钮添加到服务器功能区中。

先决条件

Microsoft SharePoint Foundation 2010

Microsoft Visual Studio 2010 中的 SharePoint 开发工具

创建 SharePoint 项目

要添加新按钮，请首先创建一个空白 SharePoint 项目。

创建 SharePoint 项目

  1. 启动 Microsoft Visual Studio 2010。

  2. 在"文件"菜单上，指向"新建"，然后单击"项目"。

  3. 在"项目类型"中的"Visual Basic"或"C#"下，选择"空白 SharePoint 项目"。

  4. 键入 AddARibbonButton 作为项目名称。单击"确定"。

  5. 在"SharePoint 自定义向导"中，选择"部署为沙盒解决方案"，然后单击"完成"。

添加新功能

可以使用功能自定义功能区。执行以下步骤将向您的解决方案中添加新功能。

添加新功能

  1. 在"解决方案资源管理器"中，右键单击"功能"，然后单击"添加功能"。

  2. 将功能的"标题"更改为 Custom Ribbon Button。

  3. 在"解决方案资源管理器"中，右键单击"Feature1"，然后单击"重命名"。键入 CustomRibbonButton 作为新名称。

  4. 在"解决方案资源管理器"中，右键单击"AddARibbonButton"项目，指向"添加"，然后选择"新建项"。

  5. 在"添加新项"对话框中，选择"空元素"模板。输入 CustomRibbonButton 作为名称。

定义自定义操作

可以使用自定义操作中的功能区 XML 定义功能区按钮。有关功能区 XML 的详细说明，请参阅服务器功能区 XML。

定义自定义操作

  1. 打开 Elements.xml 文件。

  2. 将以下 XML 粘贴到 Elements.xml 文件中。此 XML 将在文档库的"共享和跟踪"组中的"库"选项卡上添加一个新按钮。

    重要注释重要信息

    必须将 Image32by32 和 Image16by16 属性替换为有效的图像 URL。

    		 
    <?xml version="1.0" encoding="utf-8"?>
<Elements xmlns="https://schemas.microsoft.com/sharepoint/">
  <CustomAction 
    Id="Ribbon.Library.Actions.AddAButton"
    Location="CommandUI.Ribbon"
    RegistrationId="101"
    RegistrationType="List"
    Title="Add a Ribbon Button">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition
          Location="Ribbon.Library.Share.Controls._children">
          <Button Id="Ribbon.Library.Share.NewRibbonButton"
            Command="NewRibbonButtonCommand"
            Image16by16="Insert an image URL here."
            Image32by32="Insert an image URL here."
            LabelText="Hello World"
            TemplateAlias="o2" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="NewRibbonButtonCommand"
          CommandAction="javascript:alert('Hello, world');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>

部署自定义项

由于该项目是作为沙盒解决方案创建的，因此它将部署到解决方案库。

部署自定义项

  1. 按 F5。Visual Studio 2010 中的 SharePoint 开发工具将自动构建和部署功能。

  2. 导航到网站或子网站中的文档库。

  3. 单击"库"选项卡，查阅"共享和跟踪"组，然后单击"Hello World"按钮。

请参阅

任务

演练：从服务器功能区中删除按钮

概念

服务器功能区的声明性自定义项