A1sCode библиотека 1С

A1sQ.WithParam

Назначение: добавить пару Имя → Значение в Builder.Parameters при сборке fluent‑запроса.
Результат: возвращает тот же Builder для продолжения цепочки.

Сигнатура

Function WithParam(Builder, ParamName, ParamValue) Export

Как работает (по исходному коду)

Builder.Parameters.Insert(ParamName, ParamValue);
	Return Builder;

Параметры

  • Builder — структура билдера из Select().
  • ParamName — имя параметра без амперсанда (например, "D1" для &D1).
  • ParamValue — значение параметра.

Возвращает

Builder — тот же объект (для fluent‑цепочки).

Примеры

Q = A1sQ.Select("Ссылка, Наименование")
    .From("Справочник.Номенклатура КАК Ном")
    .Where("Ном.Родитель = &Parent")
    .WithParam("Parent", Родитель)
    .Build();

Нюансы и ограничения

✅ Имена параметров — без &
✅ Передаются автоматически в Build() через SetQParams
❗ Повторное добавление того же имени перезапишет значение
❗ Тип значения должен соответствовать типу поля/выражения запроса