Перейти к основному содержимому

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

Стд::БазаДанных::ПроизвольныйЗапрос Доступность: Сервер

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

Сравнение

Ссылочное

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

Базовые типы: Объект, Стд::БазаДанных::Запрос

Примеры​

Общие примеры

пер Условие: Строка

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

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

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

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

Доступность: Сервер

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

Свойства​

Текст​

Доступность: Сервер

Текст: Строка

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

Переопределение: Текст

Методы​

Выполнить​

Доступность: Сервер

Выполнить(): РезультатЗапроса<СтрокаРезультатаПроизвольногоЗапроса>
Выполняет запрос к базе данных.
Возвращает результат выполнения этого запроса.

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

Доступность: Сервер

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

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

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

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

Доступность: Сервер

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

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

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

Доступность: Сервер

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

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

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

Объект​

ВСтроку

ПолучитьТип

Представление

Последнее обновление