URL 字符串的格式说明

上次修改时间: 2010年4月16日

适用范围: SharePoint Foundation 2010

Microsoft SharePoint Foundation 使用各种形式的 URL 字符串,具体取决于上下文和所使用的成员。

SharePoint Foundation 可根据指定协议(如 http:)或字符串中左斜线 (/) 的位置来分析 URL 字符串以确定 URL 的格式。您可以根据具体的成员使用以下 URL 格式:

  • 绝对 URL,该格式指定一个完整路径,并以协议开头。例如 http://服务器/[sites/]网站/Lists/列表标题/AllItems.aspx。

  • 相对于服务器的 URL,该格式基于以左斜线开头的服务器地址,可指定一个从首要网站到文件名的完整路径。例如,/[sites/]网站/Lists/列表标题/AllItems.aspx。

  • 相对于网站的 URL,该格式基于不 以左斜线开头的网站对象 (SPWeb) 的地址,并指定一个从网站地址到文件名的完整路径。例如,Lists/列表标题/AllItems.aspx。

  • 相对于文件或文件夹的 URL,该格式基于包含文件的文件夹,不包含任何 左斜线,并指定文件的名称。例如,AllItems.aspx。

备注

不存在"相对于网站集的 URL"这一概念,传递此类 URL 可能导致代码失败。

在创建位于 %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033\IMAGES 目录中的某个图像文件的 URL 时,可指定一个使用网站集的根网站的路径,但该路径不能包括子网站。例如,可使用 /_layouts/images/MyImage.gif 来表示图像文件,但不能使用 /MySubsite/_layouts/images/MyImage.gif。例如,在路径中指定子网站可能会导致无法显示图像,这取决于从它的使用位置构造完整 URL 的方式。如果在 URL 的开头使用的不仅仅是 /_layouts,则该 URL 失败的可能性更大。

Url 标记

SharePoint Foundation 支持在相对 URL 的开头使用下列标记:

  • ~site   相对于网站 (SPWeb) 的链接。

  • ~sitecollection   相对于网站集 (SPSite) 的链接。

此外,可以在 URL 中使用下列标记:

  • {ItemId}   表示列表中的项目的整数 ID。

  • {ItemUrl}   正在处理的项目的 URL。仅适用于库中的文档。

  • {ListId}   表示列表的 GUID。

  • {SiteUrl}   网站 (SPWeb) 的 URL。

  • {RecurrenceId}   重复索引。不支持将该标记用于列表项的上下文菜单中。

请参阅

概念

高级 Extranet 支持

获取对网站、Web 应用程序和其他关键对象的引用

SharePoint 开发任务 - 如何实现?

使用列表对象和集合

其他资源

基本对象模型任务