Практические потребности заставили меня провести некоторую работу по исследованию особенностей свойства InputParameters в ADP, так как имеющаяся в MS Access документация к этому свойству по меньшей мере недостаточна, а дополнительная информация, которую можно почерпнуть из доступных источников, на удивление скудна. В частности, даже хорошо известный двухтомник, который часто называют по имени одного из его соавторов, отводит этому свойству не более нескольких абзацев, и то там нет ничего нового по сравнению с тем, что можно найти в MSDN (я пользовался вторым томом издания этой книги на английском языке, относящемся к MS Access 2000; что же касается издания для MS Access 2002, то я располагаю только первым томом - быть может, во втором томе, который я пока ещё не приобрёл, есть что-то новое?)
То, что в результате удалось обнаружить (проверялось на MS Access 2000 9.0.2812, русская версия), я тогда записал в виде статьи "для себя" и сейчас публикую с целью задать вопрос уважаемому сообществу - изменилось ли описываемое поведение в MS Access 2002? Может быть, кто-то это уже знает и тем самым избавит меня от повторения утомительных экспериментов в другой версии программы?
Итак, что выявлено в результате исследования сверх того, что можно прочесть в документации:
1) Синтаксис типа (здесь и далее рассматривается синтаксис одного параметра на вымышленном примере)
@Param1 int=[Forms]![Мояформа]![МоеПоле]
работает вполне предсказуемо, так, как об этом можно прочитать в документации, при этом квадратные скобки в большинстве случаев можно не ставить. В ссылке на поле вместо восклицательных знаков допускается также синтаксис со скобками
Forms( "Мояформа" ).Controls( "МоеПоле" )
а также их всевозможные комбинации, но практической выгоды в этом, похоже, нет.
Также очевидным образом работает в этом случае ссылка на поле в субформе:
@Param1 int = [Forms]![Мояформа]![ПолеСубформы].Form![МоеПоле]
равно как и (учитывая, что Form является свойством по умолчанию)
@Param1 int = [Forms]![Мояформа]![ПолеСубформы]![МоеПоле]
а также масса вариантов с квадратными скобками и без, а также со строковыми значениями в скобках вместо восклицательного знака в различных местах.
2) Также без проблем работает задание значения параметра с помощью функции, объявленной в отдельном модуле (не модуле формы!):
При этом вызвать таким образом функцию, объявленную в модуле формы, содержащей наше свойство InputParameters, не удаётся.
Применение функции, объявленной в отдельном модуле, в качестве значения параметра, хоть и не описано в документации, но стало широко известным.
3) Применение в строке InputParameters свойства Form (свойства, содержащего ссылку формы на неё саму)
@Param1 int=[Form]![МоеПоле]
приводит к результатам, отличным от ожидаемых. Из некоторых статей в MSDN, касающихся применения свойства InputParameters, в примерах кода в которых без комментариев используется свойство [Form], можно предположить (как это следует из опыта применения этого свойства в других свойствах формы и элементов управления), что и здесь оно должно означать ссылку на саму форму, содержащую свойство InputParameters, с которым мы работаем. Но это не так! В случае простой (не подчинённой) формы, если вы сошлётесь на поле в этой же форме, вот так:
@Param1 int=[Form]![МоеПоле]
то это работать не будет, и вместо того, чтобы взять значение из поля [МоеПоле] из этой же формы, программа будет запрашивать параметр [МоеПоле] у пользователя. На самом деле, как удалось выяснить, свойство [Form] имеет смысл применять в строке InputParameters только в подчинённой форме для ссылки на главную. Другими словами, в свойстве InputParameters (и, похоже, только в нём) конструкция [Form] означает ссылку на родительскую форму.
4) Как это уже указывалось в предыдущем пункте, в случае, когда наша форма является подчинённой, то свойство [Form] внутри InputParameters является применимым, но ссылается не на саму эту форму, а на родительскую по отношению к ней. То есть, если мы в свойстве InputParameters укажем
@Param1 int=[Form]![МоеПоле]
и если при этом в главной по отношению к этой форме есть поле [МоеПоле], то параметр будет автоматически получен из него. Если же поле с таким именем отсутствует в главной форме, то параметр с именем [МоеПоле] будет запрошен у пользователя.
В этом случае допускается также синтаксис ссылки на поле "через точку" ([Form].[МоеПоле]), причём квадратные скобки здесь также в большинстве случаев могут быть опущены.
Случай с двойной вложенностью субформ друг в друга не проверялся.
5) Следующим шагом в экспериментах было удаление ссылки [Form] из синтаксиса InputParameters, вот так:
или
Оказывается, это тоже будет работать, как в случае со ссылкой типа [Form]![МоеПоле], однако здесь была обнаружена одна важная особенность. В случае простой ссылки на имя поля без префиксов программа так же извлекает значение параметра из поля с этим именем, находящимся в главной (родительской по отношению к текущей) форме, но в дополнение к этому любое изменение значения поля [МоеПоле] пользователем (путём ввода значения и выхода из поля или путём выбора из списка) приводит к
автоматическому обновлению (Requery) набора записей формы, содержащей наше свойство InputParameters! То есть в случае задания пользователем нового критерия отбора не нужно в событии AfterUpdate этого поля вызывать метод Requery субформы! В случае же, когда используется синтаксис [Form].[МоеПоле], такого не происходит.
6)Краткий синтаксис указания ссылки на значение параметра (без [Form]) имеет ещё одну интересную особенность. Если мы вместо поля с именем [МоеПоле] главной формы создадим в модуле главной (родительской) формы свойство с таким же именем:
1.
2.
Public Property Get МоеПоле()
МоеПоле = "НужноеЗначение" 'может быть и числовым'
End Function
то это также сработает! При этом в качестве значения параметра автоматически будет подставляться значение, возвращаемое функцией Property Get.
Однако, такой подход работает лишь в случае указания имени процедуры без префикса [Form] и без пары скобок после имени процедуры, вот так:
1.
@Param1 int=[МоеПоле] или @Param1 int=МоеПоле
(работает!)
1.
@Param1 int=[Form].[МоеПоле]
(Не работает! Ни с квадратными скобками, ни без них, ни с точкой, ни с восклицательным знаком.)
Следует отметить, что в этом случае Property Get можно заменить на обычную Public Function (метод формы, они синтаксически эквивалентны), и для получения значения параметра будет автоматические будет вызываться эта функция.
Создание свойства в форме простейшим способом, путём объявления публичной переменной на уровне секции объявлений модуля формы (Public МоеПоле As Variant) нужного эффекта не даёт - переменная формы в качестве значения параметра не распознаётся, и параметр запрашивается у пользователя.
Таким образом, вопреки распространённому утверждению, в качестве значения параметра в InputParameters
можно использовать функцию в модуле формы (только не этой формы, а главной, родительской по отношению к ней). Однако в последнем случае, если мы поддадимся соблазну изменить синтаксис
на, как казалось бы, более логичный синтаксис
то это работать не будет! Параметр с именем "МоеПоле()" будет запрашиваться у пользователя.
7) И, наконец, очень интересная особенность. Если мы создадим в родительской (главной) форме поле, содержащее значение параметра с именем, в точности соответствующим имени параметра (как он объявлен в хранимой процедуре, например, без символа @), то в свойстве InputParameters описание этого параметра можно просто опустить - программа сама автоматически найдёт это поле и будет, ничего больше не спрашивая, брать значение параметра оттуда!
Всё вышесказанное наводит на мысль, что все эти возможности проектировались для того,чтобы обеспечить несложное (без программирования) осуществление связи между главной формой и подчинённой (для того же самого, для чего служат свойства формы LinkChildForm и LinkParentForm), но по какой-то не вполне ясной причине это так и осталось недокументированным.
