====== Физические и виртуальные пути ======

Методы класса [[api:dbconnector|DBConnector]], описанные в данном разделе, позволяют получить физические и виртуальные пути (URL) для сайтов, контентов и полей.
Если для экземпляра класса DBConnector [[api:dbconnector#CacheData|включено кэширование]], то, если не указано иное, результаты всех методов данного раздела кэшируются на [[developer:web_config#InternalExpirationTime|время, указанное в конфигурационном файле]].

===== GetImagesUploadUrl =====

<code csharp>
public string GetImagesUploadUrl(int site_id)
public string GetImagesUploadUrl(int site_id, bool asShortAsPossible)
</code>

Возвращает URL библиотеки сайта. Если ''asShortAsPossible == true'' возвращается относительный URL, иначе абсолютный, но если для сайта определен префикс URL загрузки, то всегда возвращается абсолютный с учетом префикса. 
Значение //asShortAsPossible// по умолчанию - //false//.

===== GetSiteLibraryDirectory =====

<code csharp>
public string GetSiteLibraryDirectory(int site_id)
</code>

Возвращает физический путь к библиотеке сайта.

===== GetActualSiteUrl =====

<code csharp>
public string GetActualSiteUrl(int site_id)
</code>

Возвращает URL корневой папки страниц сайта в соответствии с текущим режимом работы сайта (live или stage). 

===== GetSiteUrl =====

<code csharp>
public string GetSiteUrl(int site_id, bool isLive)
</code>

Возвращает абсолютный URL корневой папки страниц сайта. Параметр //isLive// определяет для какого режима нужно получить URL: live или stage.


===== GetSiteUrlRel =====

<code csharp>
public string GetSiteUrlRel(int site_id, bool isLive)
</code>

Возвращает относительный URL корневой папки страниц сайта. Параметр //isLive// определяет для какого режима нужно получить URL: live или stage.


===== GetSiteDirectory =====

<code csharp>    
public string GetSiteDirectory(int site_id, bool isLive)
</code>

Возвращает физический путь корневой папки страниц сайта.  Параметр //isLive// определяет для какого режима нужно получить URL: live или stage.


===== GetContentUploadUrl =====
		
<code csharp>
public string GetContentUploadUrl(int site_id, string content_name)
</code>

Возвращает URL библиотеки контента. Поддерживаются имена контентов в формате ''SiteName.ContentName''.

===== GetContentLibraryDirectory =====
		
<code csharp>
public string GetContentLibraryDirectory(int site_id, int content_id)
</code>

Возвращает физический путь к библиотеке контента.

===== GetDirectoryForFileAttribute =====
		
<code csharp>
public string GetDirectoryForFileAttribute(int attrId)
</code>

Возвращает физический путь к корневой папке поля. 
Учитывает настройки **Использовать библиотеку сайта** (**Use Site Library**) и **Подпапка для файлов** (**File Subfolder**) [[:field|уровня поля]].

===== GetUrlForFileAttribute =====

<code csharp>
public string GetUrlForFileAttribute(int fieldId)
public string GetUrlForFileAttribute(int fieldId, bool asShortAsPossible)
</code>

Возвращает URL корневой папки поля. 
Учитывает настройки **Использовать библиотеку сайта** (**Use Site Library**) и **Подпапка для файлов** (**File Subfolder**) [[:field|уровня поля]], а также папки для динамических изображений.
Если ''asShortAsPossible == true'' возвращается относительный URL, иначе абсолютный, но если для сайта определен префикс URL загрузки, то всегда возвращается абсолютный с учетом префикса.
Значение //asShortAsPossible// по умолчанию - //true//.