URL-адреса и токены в SharePoint
Узнайте, как составлять URL-адреса и использовать токены URL-адресов в SharePoint.
Типы URL-адресов в SharePoint
SharePoint анализирует строки URL-адресов для определения их формы на основе указанного протокола (например, http:) или размещении косой черты (/) в строке. В зависимости от конкретного элемента можно использовать следующие формы URL-адресов:
Абсолютный URL-адрес указывает полный путь и начинается с обозначения протокола. Например,
http://domain_or_server/[sites/] Web_Site/Lists/ List_Title/AllItems.aspx.URL-адрес относительно домена основан на адресе домена (он может быть именем сервера) и всегда начинается с косой черты. Он определяет полный путь от веб-сайта верхнего уровня к имени файла. Например, /[
sites/] веб_сайт/Lists/ название_списка/AllItems.aspx.URL-адрес относительно веб-сайта основан на адресе объекта веб-сайта (SPWeb). Он не начинается с косой черты и указывает полный путь от адреса веб-сайта к имени файла. Например,
Lists/List_Title/AllItems.aspx.URL-адрес файла или папки основан на папке, содержащей файл. Он не содержит косой черты. Он просто указывает имя файла. Например,
AllItems.aspx.
Примечание.
Не существует такого понятия, как "URL-адрес относительно семейства веб-сайтов". Передача такого URL-адреса может вызвать сбой кода.
Рекомендации для URL-адресов изображений
При создании URL-адреса файла изображения, расположенного в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\15\TEMPLATE\LAYOUTS\1033\IMAGES, укажите путь, который использует корневой веб-сайт семейства веб-сайтов, но не включает дочерний сайт в пути. Например, используйте путь /_layouts/images/MyImage.gif вместо /MySubsite/_layouts/images/MyImage.gif. Это связано с тем, что URL-адреса дочерних сайтов сопоставляются по-разному в зависимости от того, где они используются. Эти варианты можно игнорировать, если вы всегда используете URL-адрес относительно корневого веб-сайта.
Маркеры URL-адресов в SharePoint
SharePoint поддерживает маркеры, перечисленные в следующих таблицах, для использования в надстройках SharePoint или решениях ферм. Кроме того, некоторые маркеры можно использовать только в приложениях. Дополнительные сведения о них см. в статье Строки URL-адресов и маркеры в надстройках SharePoint.
Маркеры, перечисленные в таблицах в этом разделе, можно использовать в URL-адресах в различных ситуациях в ходе разработки SharePoint, например в дополнительных действиях и ссылках на пользовательских страницах. Некоторые из этих маркеров невозможно использовать в определенных контекстах. Три наиболее важных места, где можно использовать только ограниченный список маркеров, — это начальная страница приложения, пользовательское действие на хост-сайте и свойство Src части приложения. Эти случаи вынесены в отдельные столбцы, но они не являются единственными областями применения маркеров.
В столбце StartPage указано, можно ли использовать маркер в элементе манифеста приложения StartPage. В столбце Дополнительное действие указано, можно ли использовать маркер в URL-адресе пользовательского действия на хост-сайте. В столбце Веб-часть приложения указано, можно ли использовать маркер в свойстве веб-части приложения Src .
Маркеры, которые можно использовать в начале URL-адреса
| Маркер | Во что разрешается | StartPage | Дополнительное действие | Веб-часть приложения | Замечания |
|---|---|---|---|---|---|
| ~controlTemplates |
URL-адрес виртуальной папки ControlTemplates для текущего веб-сайта. |
Нет |
Нет |
Нет |
|
| ~layouts |
URL-адрес виртуальной папки Layouts для текущего веб-сайта. |
Нет |
Нет |
Нет |
|
| ~site |
URL-адрес текущего веб-сайта. |
Нет |
Нет |
Да |
|
| ~sitecollection |
URL-адрес родительского семейства сайтов для текущего веб-сайта. |
Нет |
Нет |
Да |
За исключением случаев, когда указано иное, ни один из этих маркеров в следующей таблице не может использоваться в части пути значения свойства Src части приложения. Столбец Веб-часть приложения относится к их использованию в части значения query string.
Маркеры, которые можно использовать в URL-адресе
| Маркер | Во что разрешается | StartPage | Дополнительное действие | Веб-часть приложения | Замечания |
|---|---|---|---|---|---|
| {ControlTemplates} |
URL-адрес виртуальной папки ControlTemplates для текущего веб-сайта. |
Нет |
Нет |
Нет |
|
| {ItemId} |
Идентификатор элемента в списке или библиотеке (целое значение). |
Нет |
Да |
Нет |
|
| {ItemUrl} |
URL-адрес элемента, с которым выполняется действие. |
Нет |
Да |
Нет |
|
| {Layouts} |
URL-адрес виртуальной папки Layouts для текущего веб-сайта. |
Нет |
Нет |
Нет |
|
| {ListId} |
Идентификатор текущего списка (GUID). |
Нет |
Да |
Нет |
|
| {RecurrenceId} |
Индекс повторения повторяющегося события. |
Нет |
Да |
Нет |
Этот маркер не поддерживается для контекстных меню элементов списков. |
| {Site} |
URL-адрес текущего веб-сайта. |
Нет |
Да |
Да |
|
| {SiteCollection} |
URL-адрес родительского сайта для текущего веб-сайта. |
Нет |
Да |
Да |
|
| {SiteUrl} |
URL-адрес текущего веб-сайта. |
Нет |
Да |
Нет |
|
| {Source} |
URL-адрес HTTP-запроса. |
Нет |
Да |
Нет |