演练:向服务器功能区中添加组
上次修改时间: 2011年2月7日
适用范围: SharePoint Foundation 2010
本文内容
创建 SharePoint 项目
添加新功能
定义自定义操作
部署自定义项
本主题介绍如何在 Microsoft SharePoint Foundation 中将新组添加到服务器功能区中。若要添加组,应在功能区上标识将显示该组的选项卡。还应定义组中的控件以及该组将如何呈现这些控件。通过以下过程可将新组添加到网站的"网页"选项卡。
先决条件
Microsoft SharePoint Foundation 2010
Microsoft Visual Studio 2010 中的 SharePoint 开发工具
创建 SharePoint 项目
若要添加新组,应首先创建一个空白 SharePoint 项目。
创建 SharePoint 项目
启动 Visual Studio 2010。
在"文件"菜单上,指向"新建",然后单击"项目"。
在"项目类型"中的"Visual Basic"或"C#"下,选择"空白 SharePoint 项目"。
键入 AddARibbonGroup 作为项目名称。单击"确定"。
在"SharePoint 自定义向导"中,选择"部署为沙盒解决方案",然后单击"完成"。
添加新功能
可以使用功能自定义功能区。执行以下步骤将向您的解决方案中添加新功能。
添加新功能
在"解决方案资源管理器"中,右键单击"功能",然后选择"添加功能"。
将功能的"标题"更改为Custom Ribbon Group。
在"解决方案资源管理器"中,右键单击"Feature1",然后选择"重命名"。键入 CustomRibbonGroup 作为新名称。
在"解决方案资源管理器"中,右键单击"AddARibbonGroup"项目,指向"添加",然后单击"新建项"。
在"添加新项"对话框中,选择"空元素"模板。输入 CustomRibbonGroup 作为名称。
定义自定义操作
将使用自定义操作中的功能区 XML 定义功能区组。这将确定该组在功能区上的显示位置。有关功能区 XML 的详细说明,请参阅服务器功能区 XML。
定义自定义操作
打开 Elements.xml 文件。
将以下 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>
部署自定义项
由于该项目是作为沙盒解决方案创建的,因此它将部署到解决方案库。
部署自定义项
按 F5。Visual Studio 2010 中的 SharePoint 开发工具将自动构建和部署功能。
导航到网站或子网站的主页。
单击"网页"选项卡,寻找"自定义"组,然后单击"Hello, World"或"Good-bye, World"按钮。