Класс Insert

Общие сведения

Класс Terrasoft.Core.DB.Insert предназначен для построения запросов на добавление записей в таблицы базы данных Creatio. В результате создания и конфигурирования экземпляра этого класса будет построен запрос в базу данных приложения в виде SQL-выражения INSERT. В результате выполнения запроса возвращается количество задействованных запросом записей.

Класс Terrasoft.Core.DB.Insert

Конструкторы

public Entity((UserConnection userConnection))

Создает новый экземпляр класса Entity для заданного пользовательского подключения UserConnection.

---

public Insert((UserConnection userConnection))

Создает экземпляр класса с указанным UserConnection.

---

public Insert((Insert source))

Создает экземпляр класса, являющийся клоном экземпляра, переданного в качестве аргумента.

---

Свойства

Табл. 1. — Основные свойства класса Insert

UserConnection

Terrasoft.Core.UserConnection

Пользовательское подключение, используемое при запросе.

---

Source

Terrasoft.Core.DB.ModifyQuerySource

Источник данных

---

Parameters

Terrasoft.Core.DB.QueryParameterCollection

Коллекция параметров запроса.

---

HasParameters

bool

Определяет, имеет ли запрос параметры.

---

BuildParametersAsValue

bool

Определяет, добавлять ли параметры запроса в текст запроса как значения.

---

ColumnValues

Terrasoft.Core.DB.ModifyQueryColumnValueCollection

Коллекция значений колонок запроса.

---

ColumnValuesCollection

List<ModifyQueryColumnValueCollection>

Коллекция значений колонок для множественного добавления записей (см. "Функциональность многострочного добавления данных. Класс Insert").

---

Методы

Табл. 2. — Основные методы класса Insert

void ResetCachedSqlText(())

Очищает кэшированный текст запроса.

---

QueryParameterCollection GetUsingParameters(())

Возвращает коллекцию параметров, используемых запросом.

---

void ResetParameters(())

Очищает коллекцию параметров запроса.

---

void SetParameterValue((string name, object value))

Устанавливает значение для параметра запроса.

Параметры:

• name — название параметра;
• value — значение.

---

void InitializeParameters(())

Инициализирует коллекцию параметров запроса.

---

int Execute(())

Выполняет запрос. Возвращает количество задействованных запросом записей.

---

int Execute((DBExecutor dbExecutor))

Выполняет запрос, используя экземпляр DBExecutor. Возвращает количество задействованных запросом записей.

---

Insert Into((string schemaName))
Insert Into((ModifyQuerySource source))

Добавляет в текущий запрос источник данных.

Параметры:

• schemaName — название схемы;
• source — источник данных.

---

Insert Set((string sourceColumnAlias, Select subSelect))
Insert Set((string sourceColumnAlias, Query subSelectQuery))
Insert Set((string sourceColumnAlias, QueryColumnExpression columnExpression))
Insert Set((string sourceColumnAlias, QueryParameter parameter))

Добавляет в текущий запрос предложение SET для присвоения колонке переданного выражения или параметра. Возвращает текущий экземпляр Insert.

Параметры:

• sourceColumnAlias — псевдоним колонки;
• subSelect — подзапрос на выборку;
• subSelectQuery — подзапрос;
• columnExpression — выражение колонки;
• parameter — параметр запроса.

---

Insert Values(())

Инициализирует значения для множественного добавления записей. (см. "Функциональность многострочного добавления данных. Класс Insert")

---

Смотрите также:

• Примеры использования класса Insert для построения запросов на добавление данных