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

  • 项目

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

适用范围： SharePoint Foundation 2010

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

本主题介绍如何在 Microsoft SharePoint Foundation 中将新组添加到服务器功能区中。若要添加组，应在功能区上标识将显示该组的选项卡。还应定义组中的控件以及该组将如何呈现这些控件。通过以下过程可将新组添加到网站的"网页"选项卡。

先决条件

Microsoft SharePoint Foundation 2010

Microsoft Visual Studio 2010 中的 SharePoint 开发工具

创建 SharePoint 项目

若要添加新组，应首先创建一个空白 SharePoint 项目。

创建 SharePoint 项目

  1. 启动 Visual Studio 2010。

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

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

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

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

添加新功能

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

添加新功能

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

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

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

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

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

定义自定义操作

将使用自定义操作中的功能区 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.WikiPageTab.CustomGroup" 
    Location="CommandUI.Ribbon">
    <CommandUIExtension>
      <CommandUIDefinitions>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Groups._children">
          <Group 
            Id="Ribbon.WikiPageTab.CustomGroup" 
            Sequence="55" 
            Description="Custom Group" 
            Title="Custom" 
            Command="EnableCustomGroup" 
            Template="Ribbon.Templates.Flexible2">
            <Controls Id="Ribbon.WikiPageTab.CustomGroup.Controls">
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupHello" 
                Command="CustomGroupHelloWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Hello, World" 
                TemplateAlias="o2" 
                Sequence="15" />
              <Button 
                Id="Ribbon.WikiPageTab.CustomGroup.CustomGroupGoodbye" 
                Command="CustomGroupGoodbyeWorld" 
                Image16by16="Insert an image URL here." 
                Image32by32="Insert an image URL here." 
                LabelText="Good-bye, World" 
                TemplateAlias="o2" 
                Sequence="18" />
            </Controls>
          </Group>
        </CommandUIDefinition>
        <CommandUIDefinition 
          Location="Ribbon.WikiPageTab.Scaling._children">
          <MaxSize 
            Id="Ribbon.WikiPageTab.Scaling.CustomGroup.MaxSize" 
            Sequence="15" 
            GroupId="Ribbon.WikiPageTab.CustomGroup" 
            Size="LargeLarge" />
        </CommandUIDefinition>
      </CommandUIDefinitions>
      <CommandUIHandlers>
        <CommandUIHandler 
          Command="EnableCustomGroup"
          CommandAction="javascript:return true;" />
        <CommandUIHandler 
          Command="CustomGroupHelloWorld" 
          CommandAction="javascript:alert('Hello, world!');" />
        <CommandUIHandler 
          Command="CustomGroupGoodbyeWorld" 
          CommandAction="javascript:alert('Good-bye, world!');" />
      </CommandUIHandlers>
    </CommandUIExtension>
  </CustomAction>
</Elements>

部署自定义项

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

部署自定义项

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

  2. 导航到网站或子网站的主页。

  3. 单击"网页"选项卡，寻找"自定义"组，然后单击"Hello, World"或"Good-bye, World"按钮。

请参阅

任务

演练：向服务器功能区中添加选项卡

概念

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