自定义操作
上次修改时间: 2010年4月2日
适用范围: SharePoint Foundation 2010
自定义操作表示对用户可见的服务器功能区、菜单或链接自定义项。可以将自定义操作绑定到列表类型、内容类型、文件类型或编程标识符 (ProgID)。
可能的范围:
场:是
Web 应用程序:是
网站集:是
网站:是
定义用户界面的自定义操作
可以使用自定义操作在多个位置修改用户界面。这包括服务器功能区和 SharePoint Foundation 中的其他菜单。
服务器功能区的自定义操作
使用 CustomAction 元素向功能区添加控件时,支持文本框和下拉列表等控件。然而,在功能区中不支持用户控件和 Web 部件。有关功能区的详细信息,请参阅 SharePoint Foundation 中的服务器功能区。
其他菜单的自定义操作
若要定义特定菜单的自定义操作,必须通过将位置设置为相应 SharePoint Foundation 命名空间并使用 SharePoint Foundation 用于标识该特定位置的 ID 来标识菜单。
例如,若要在"网站设置"页面上添加自定义操作,请将 CustomAction 元素的 Location 属性设置为 Microsoft.SharePoint.SiteSettings 并通过 GroupId 属性指定页面中的特定区域。
有关 SharePoint Foundation 安装中使用的默认自定义操作 ID 和位置的列表,请参阅默认自定义操作位置和 ID。
自定义操作的 Url 标记
SharePoint Foundation 支持在相对 URL 的开头使用下列标记:
~site - 相对于网站 (SPWeb) 的链接。
~sitecollection - 相对于网站集 (SPSite) 的链接。
此外,可以在 URL 中使用下列标记:
{ItemId} - 表示列表中的项目的整数 ID。
{ItemUrl} - 对其执行操作的项目的 URL。仅适用于库中的文档。
{ListId} - 表示列表的 GUID。
{SiteUrl} - 网站 (SPWeb) 的 URL。
{RecurrenceId} - 重复索引。不支持将该标记用于列表项的上下文菜单中。