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-адреса файла изображения, расположенного в каталоге %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-адреса

За исключением случаев, когда указано иное, ни один из этих маркеров в следующей таблице не может использоваться в части пути значения свойства Src части приложения. Столбец Веб-часть приложения относится к их использованию в части значения query string.

Маркеры, которые можно использовать в URL-адресе

См. также

•  Создавайте решения фермы в SharePoint

• Расширенная поддержка экстрасети

• Получение ссылок на сайты, веб-приложения и другие ключевые объекты

• Работа с объектами List и коллекциями

• Базовые задачи объектной модели