Свойство 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 и обратная связь.