Поделиться через

Описание видов строк URL-адресов

  • Статья

Дата последнего изменения: 16 апреля 2010 г.

Применимо к: SharePoint Foundation 2010

В Microsoft SharePoint Foundation используются различные формы строк URL-адресов, определяемые контекстом и используемыми элементами.

SharePoint Foundation разбирает строки URL-адресов, чтобы определить форму URL-адреса, основанного на указанном протоколе (например, http:) или в расположении косой черты (/) в строке. В зависимости от определенного члена можно использовать следующие формы URL-адресов.

  • Абсолютный URL-адрес, который указывает полный путь и начинается с указания протокола. Например, http://сервер/[sites/]веб-сайт/Lists/название_списка/AllItems.aspx.

  • URL-адрес относительно сервера, который основан на адресе сервера и начинается с косой черты, задавая полный путь от веб-сайта верхнего уровня к имени файла. Например: /[sites/]веб-сайт/Lists/название_списка/AllItems.aspx.

  • URL-адрес относительно веб-сайта, который основан на адресе объекта веб-сайта (SPWeb) и не начинается с косой черты, задавая полный путь от адреса веб-сайта к имени файла. Например: Lists/название_списка/AllItems.aspx.

  • Относительный URL-адрес к файлу или папке, основанный на папке, содержащей файл, который не содержит никаких косых черт и указывает имя файла. Например, AllItems.aspx.

ПримечаниеПримечание

   Не существует такого понятия, как «URL-адрес относительно семейства сайтов»; передача такого URL-адреса может вызвать сбой кода.

При создании URL-адреса файла изображения, находящегося в каталоге %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS\1033\IMAGES, укажите путь, использующий корневой веб-сайт семейства сайтов, но не включающий дочерний сайт. Например, используйте путь /_layouts/images/MyImage.gif вместо /MySubsite/_layouts/images/MyImage.gif. Включение дочернего сайта в путь может сделать изображение недоступным для отображения, в зависимости от того, как строится полный URL-адрес от места его использования. Так, URL-адрес из предыдущего примера с большой вероятностью вызовет ошибку, если в начале пути будет содержаться что-либо еще, помимо /_layouts.

Маркер URL-адреса

SharePoint Foundation поддерживает следующие маркеры, с которых может начинаться относительный URL-адрес:

  • ~site   Ссылка относительно веб-сайта (SPWeb).

  • ~sitecollection   Ссылка относительно семейства сайтов (SPSite).

Кроме того, в URL-адресе можно использовать следующие маркеры:

  • {ItemId}   Целочисленный идентификатор, представляющий элемент списка.

  • {ItemUrl}   URL-адрес элемента, с которым выполняется действие. Применим только к документам в библиотеках.

  • {ListId}   GUID, представляющий список.

  • {SiteUrl}   URL-адрес веб-сайта (SPWeb).

  • {RecurrenceId}   Индекс повторения. Этот маркер не поддерживается для контекстных меню элементов списка.

См. также

Концепции

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

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

Задачи разработки в SharePoint. Практическое руководство.

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

Другие ресурсы

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