SharePoint 2013 中的 URL 和标记
-
绝对 URL 指定完整路径并以协议开头。例如，http://domain_or_server/[sites/]Web_Site/Lists/List_Title/AllItems.aspx。
-
相对于域的 URL 基于域（可能为服务器的名称）地址并始终以正斜杠开头。它指定从首要网站到文件名的完整路径。例如，/[sites/]Web_Site/Lists/List_Title/AllItems.aspx。
-
相对于网站的 URL 基于网站对象的地址 (SPWeb)。它不 以正斜杠开头，并指定从网站地址到文件名的完整路径。例如，Lists/List_Title/AllItems.aspx。
-
相对于文件或文件夹的 URL 基于包含文件的文件夹。它不包含任何 左斜杠，而仅指定文件的名称。例如，AllItems.aspx。
 注释 |
|---|
|
不存在"相对于网站集的 URL"这一概念；传递此类 URL 可能会导致代码失败。 |
SharePoint 2013 允许在 SharePoint 相关应用程序或场解决方案中使用在以下各表中列出的标记。有关详细信息，请参阅 SharePoint 应用程序中的 URL 字符串和标记。
本节表格中的标记在进行 SharePoint 开发时可以用于各种情况下的 URL 中，例如在自定义操作中和自定义页的链接中使用。在某些上下文中，不能使用其中的一些标记。在三个最重要的位置，仅可使用受限的标记列表，它们是应用程序的起始页、主机 Web 上的自定义操作和应用程序部件的 Src 属性。这些位置将在单独的列中标注，但这三者不构成可以使用标记的位置的详尽列表。
StartPage 列将指定是否可以在应用程序清单的 StartPage 元素中使用令牌。自定义操作列将指定是否可以在托管 Web 的自定义操作的 URL 中使用令牌。应用程序部件列将指定是否可以在应用程序部件的 Src 属性中使用令牌。
|
标记 |
解析为 |
StartPage |
自定义操作 |
应用程序部件 |
备注 |
|---|---|---|---|---|---|
|
~controlTemplates |
当前网站的 ControlTemplates 虚拟文件夹的 URL。 |
否 |
否 |
否 |
|
|
~layouts |
当前网站的 Layouts 虚拟文件夹的 URL。 |
否 |
否 |
否 |
|
|
~site |
当前网站的 URL。 |
否 |
否 |
是 |
|
|
~sitecollection |
当前网站的父网站集的 URL。 |
否 |
否 |
是 |
除非另有说明，否者下表中的这些标记均不可以用在应用程序部件 Src 属性值的路径部分。应用程序部件列表示可以在值的查询字符串部分使用它们。
|
标记 |
解析为 |
StartPage |
自定义操作 |
应用程序部件 |
备注 |
|---|---|---|---|---|---|
|
{ControlTemplates} |
当前网站的 ControlTemplates 虚拟文件夹的 URL。 |
否 |
否 |
否 |
|
|
{ItemId} |
列表或库中的项目的 ID（整数）。 |
否 |
是 |
否 |
|
|
{ItemUrl} |
正在处理的项目的 URL。 |
否 |
是 |
否 |
|
|
{Layouts} |
当前网站的 Layouts 虚拟文件夹的 URL。 |
否 |
否 |
否 |
|
|
{ListId} |
当前列表的 ID（一个 GUID）。 |
否 |
是 |
否 |
|
|
{RecurrenceId} |
定期事件的定期索引。 |
否 |
是 |
否 |
不支持将该标记用于列表项的上下文菜单中。 |
|
{Site} |
当前网站的 URL。 |
否 |
是 |
是 |
|
|
{SiteCollection} |
当前网站的父网站的 URL。 |
否 |
是 |
是 |
|
|
{SiteUrl} |
当前网站的 URL。 |
否 |
是 |
否 |
|
|
{Source} |
HTTP 请求 URL。 |
否 |
是 |
否 |
