Свойство Report.InputParameters (Access)
Используйте свойство InputParameters , чтобы указать или определить входные параметры, передаваемые инструкции SQL в свойстве RecordSource формы, отчета или хранимой процедуры при использовании в качестве источника записей в проекте Microsoft Access (ADP). Для чтения и записи, String.
Синтаксис
expression. InputParameters
Выражение Переменная, представляющая объект Report .
Замечания
При использовании со свойством RecordSource
Пример строки свойства InputParameters , используемой с инструкцией SQL в свойстве RecordSource , будет использовать следующий синтаксис.
state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]
Это приведет к тому, что параметру state будет присвоено текущее значение элемента управления StateList , а пользователю будет предложено ввести параметр salesyear . Если бы были другие параметры, отсутствуют в этом списке, им будут назначены значения по умолчанию.
Запрос должен выполняться с одним маркером для каждого параметра, отличного от параметра по умолчанию в списке InputParameters .
Команда обновления или запроса (с помощью меню, клавиатуры или панели навигации) в Access должна активировать повторное выполнение запроса. Пользователи могут сделать это в коде, вызвав стандартный метод Requery . Если значение параметра привязано к элементу управления в форме, текущее значение элемента управления используется во время запроса. При изменении значения элемента управления запрос не выполняется автоматически.
При использовании с хранимой процедурой
В примере строки свойства InputParameters , используемой с хранимой процедурой, будет использоваться следующий синтаксис.
@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]
Это приведет к тому, что @state параметру будет присвоено текущее значение элемента управления StateList , а пользователю будет предложено ввести @salesyear параметр . При наличии других параметров хранимой процедуры, не хранящихся в этом списке, они получат значения по умолчанию.
Хранимая процедура должна выполняться с помощью командной строки, содержащей синтаксис {call } с одним маркером для каждого параметра, отличного от параметра по умолчанию в списке InputParameters .
Команда обновления или повторного запроса (с помощью меню, клавиатуры или панели навигации) в Access должна активировать повторное выполнение хранимой процедуры. Пользователи могут сделать это в коде, вызвав стандартный метод Requery . Если значение параметра привязано к элементу управления в форме, текущее значение элемента управления используется во время запроса. Хранимая процедура не выполняется автоматически при изменении значения элемента управления.
Это диалоговое окно построителя вызывается при первом выборе хранимой процедуры в качестве источника записей формы, если хранимая процедура имеет какие-либо параметры. После первоначального создания строки InputParameters это же диалоговое окно используется в качестве построителя для изменения строки. Однако в этом случае список параметров исходит из того, что уже существует в строке.
Значения параметров также задаются в коде с помощью объектов ADO иado объекта данных ActiveX. Если результат возвращает результирующий набор, форму можно привязать к нему, задав свойство Recordset формы. Кодирование ADO — это единственный способ обработки хранимых процедур, которые не возвращают результирующие наборы, такие как запросы действий, возвращающие выходные параметры, или те, которые возвращают несколько результирующих наборов.
Поддержка и обратная связь
Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.