ПроизвольныйЗапрос

Иерархия типа

Объект для выполнения запросов к базе данных сформулированных на языке запросов.

Пример

если ...
    Условие = "ГДЕ Т.Цена > &Цена"
иначе
    Условие = ""
;         

знч Запрос = новый ПроизвольныйЗапрос(
    "ВЫБРАТЬ
        Т.Ссылка КАК Ссылка 
        Т.Код КАК Код,
        Т.Наименование КАК Наименование
    ИЗ
        Товары КАК Т
    %Условие
    УПОРЯДОЧИТЬ ПО
        Наименование,
        Ссылка
")

Сравнение ссылочное

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

ПроизвольныйЗапрос

ПроизвольныйЗапрос(Текст: Строка = "")

Создает новый запрос и устанавливает в свойство Текст текст запроса Текст.

Свойства

Текст

Текст запроса, который нужно выполнить.
При изменении свойства никаких проверок не выполняется - т.е. можно например установить в свойства заведомо некорректный текст запроса и при этом не возникнет ошибок.

Методы

Выполнить

Выполнить(): РезультатЗапроса<СтрокаРезультатаПроизвольногоЗапроса>

Выполняет запрос к базе данных.
Возвращает результат выполнения этого запроса.

НайтиПараметры

НайтиПараметры(): ЧитаемоеСоответствие<Строка, ТипПараметраЗапроса>

Не поддерживаются неопределенные таблицы - в запросе, временные таблицы в котором созданы вне переданного пакета запросов, найти параметры не удастся — будет выдана ошибка о том, что таблица не найдена.

Возвращает имена и типы параметров (через свойство Типы), присутствующих в тексте запросов.
Типы параметров могут быть определены не точно и не всегда — возвращаются предположительно допустимые типы для параметра. Если определить допустимые типы для параметра не удалось — множество типов будет пустым. Например, в запросе Запрос{ВЫБРАТЬ &Параметр} тип параметра Параметр определен не будет. Если в тексте запроса присутствуют ошибки будет выброшено исключение такое же как при попытке выполнить этот запрос. При этом, т.к. значения параметров не используется (и их типы не известны) часть ошибок не будет обнаружена.

УстановитьИсточникДанных

УстановитьИсточникДанных(
  Имя: Строка,
  Источник: ОписаниеИсточникаДанных<Объект>|Обходимое<Объект>)

Устанавливает значение Значение источнику данных запроса Источник.
Источники данных на основе коллекций доступны для обращения в тексте запроса с помощью синтаксиса ИЗ &ИмяИсточника. С помощью этого метода можно передавать коллекции (или явно описанные источники данных) данных в запрос, для использования в секции ИЗ запроса.
Никаких проверок не выполняется:

• можно установить значение источника которого нет в тексте запроса
• можно повторно установить значение источника (затерев тем самым предыдущее)

УстановитьПараметр

УстановитьПараметр(
  Имя: Строка,
  Значение: Объект?)

Устанавливает значение Значение параметру запроса Имя.
Параметры доступны для обращения в тексте запроса с помощью синтаксиса &ИмяПараметра. С помощью этого метода можно передавать переменные в запрос, например, для использования в условиях запроса.
Никаких проверок не выполняется:

• можно установить значение параметра которого нет в тексте запроса
• можно повторно установить значение параметра (затерев тем самым предыдущее)

Список унаследованных методов

Объект