Класс Insert

Сложный

PDF

Пространство имен Terrasoft.Core.DB.

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

Важно. При работе с классом Insert на добавленные записи не применяются права доступа по умолчанию. Пользовательское соединение используется только для доступа к таблице базы данных.

На заметку. Полный перечень методов и свойств класса Insert, его родительских классов, а также реализуемых им интерфейсов, можно найти в Библиотеке .NET классов.

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

Entity(UserConnection userConnection)

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

Insert(UserConnection userConnection)

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

Insert(Insert source)

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

Свойства

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>

Коллекция значений колонок для множественного добавления записей.

Методы

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()

Инициализирует значения для множественного добавления записей.