====== Вспомогательные методы ======

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


===== FieldID =====

<code csharp>
public int FieldID(int site_id, string content_name, string field_name)
</code>

Возвращает идентификатор поля.

=== Параметры === 
  * //site_id// - идентификатор сайта
  * //content_name// - имя контента. Поддерживаются имена контентов в формате ''SiteName.ContentName''.
  * //field_name// - имя поля

===== FieldName =====

<code csharp>
public string FieldName(int site_id, string content_name, string field_name)
</code>

Вспомогательный метод, возвращающий внутреннее имя поля. Используется при формировании ключей коллекции //Values// для метода [[api:dbconnector:update_article#AddFormToContent]].

=== Параметры === 
  * //site_id// - идентификатор сайта
  * //content_name// - имя контента. Поддерживаются имена контентов в формате ''SiteName.ContentName''.
  * //field_name// - имя поля
  

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


===== FormatField =====
<code csharp>
public string FormatField(string key, int site_id)
public string FormatField(string key, int site_id, isLive)
</code>

Данный метод выполняет [[:edit:url_auto_replace|замену плейсхолдеров на URL]]. Если параметр //isLive// не задан, то используется инвертированное значение свойства [[api:qpage#IsStage]].

Замена плейсхолдеров осуществляется на следующие URL:
  * [[api:dbconnector:paths#GetImagesUploadUrl]]
  * [[api:dbconnector:paths#GetSiteUrl]] или [[api:dbconnector:paths#GetSiteUrlRel]] в зависимости от параметра конфигурации [[developer:web_config#UseAbsoluteSiteUrl]].

Нужно применять данный метод при чтении данных статей во всех случаях, кроме использования LINQ-To-SQL классов и функции [[api:qpage:field#Field]], в которые эта возможность уже встроена автоматически.


===== GetSiteId =====

<code csharp>
public int GetSiteId(string name)
</code>

Получение идентификатора сайта по имени. 
===== GetSiteIdByContentId =====

<code csharp>
public Int32 GetSiteIdByContentId(int contentId)
</code>

Получение идентификатора сайта по идентификатору контента.

===== GetSiteName =====

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

Получение имени сайта по его идентификатору.

===== GetContentId =====

<code csharp>
public int GetContentId(int siteId, string contentName)
</code>

Получение идентификатора контента по имени контента и идентификатору сайта. Поддерживаются имена контентов в формате ''SiteName.ContentName'' (можно получить идентфикаторы контентов с разных сайтов в пределах одной базы).

===== GetContentIdForAttribute =====

<code csharp>
public int GetContentIdForAttribute(int id)
</code>

Получение идентификатора контента по идентификатору поля.

===== GetContentIdForItem =====

<code csharp>
public int GetContentIdForItem(int ItemID)
</code>

Получение идентификатора контента по идентификатору статьи. Результат метода кэшируется на время [[developer:web_config#InternalLongExpirationTime]] указанное в конфигурационном файле.

===== GetContentName =====

<code csharp>
public string GetContentName(int contentId)
</code>

Получение имени контента по его идентификатору.

===== GetContentFieldValue =====

<code csharp>
public string GetContentFieldValue(int itemID, string fieldName)
</code>

Метод, позволяеющий прочитать значения поля выбранной статьи в виде строки. На результат данного метода влияет свойство [[api:dbconnector#IsStage]]. При ''IsStage == true'' возвращаются данные текущей статьи, иначе данные опубликованной.
Если статья или поле не найдено, если в поле хранится NULL, возвращается пустая строка.
=== Параметры ===
  * //itemID// - ID статьи
  * //fieldName// - имя поля