Propriedade Form.InputParameters (Access)

Use a propriedade InputParameters para especificar ou determinar os parâmetros de entrada que são passados para uma instrução SQL na propriedade RecordSource de um formulário ou relatório, ou um procedimento armazenado quando usado como a fonte de registro em um projeto do Microsoft Access (.adp). String de leitura/gravação.

Sintaxe

mais simples. Parâmetros de entrada

expressão Uma variável que representa um objeto Form.

Comentários

Quando usado com uma propriedade RecordSource

Um exemplo de sequência da propriedade InputParameters usada com uma instrução SQL na propriedade RecordSource teria a seguinte sintaxe.

state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Enter year of interest]

Isso resultaria no parâmetro state sendo definido como o valor atual do controle StateList e o usuário sendo solicitado a fornecer o parâmetro salesyear . Se existissem outros parâmetros não listados, eles receberiam os valores padrão atribuídos.

A consulta deve ser executada com um marcador para cada parâmetro não padrão na lista InputParameters .

Um comando de atualização ou repetição de consulta (por meio de menu, teclado ou barra de navegação) no Access deve disparar uma nova execução da consulta. Os usuários podem fazer isso no código chamando o método Requery padrão. Se o valor de um parâmetro for acoplado a um controle no formulário, o valor atual do controle será usado na nova consulta. A consulta não é automaticamente reexecutada quando o valor do controle é alterado.

Quando usado com um procedimento armazenado

Uma cadeia de caracteres de propriedade InputParameters de exemplo usada com um procedimento armazenado usaria a sintaxe a seguir.

@state char=[Forms]![formname]![StateList], @salesyear smallint=[Forms]![formname]![Enter year of interest]

Isso resultaria no @state parâmetro sendo definido como o valor atual do controle StateList e o usuário sendo solicitado a fornecer o @salesyear parâmetro. Se houvesse outros parâmetros para o procedimento armazenado que não estivessem nesta lista, eles obteriam valores padrão atribuídos.

O procedimento armazenado deve ser executado usando uma cadeia de caracteres de comando que contém a sintaxe {call } com um marcador para cada parâmetro não padrão na lista InputParameters .

Um comando atualizar ou repetir consulta (por meio de menu, teclado ou barra de navegação) no Access deve disparar uma nova execução do procedimento armazenado. Os usuários podem fazer isso no código chamando o método Requery padrão. Se o valor de um parâmetro estiver acoplado a um controle no formulário, o valor atual do controle será usado quando a consulta for executada novamente. O procedimento armazenado não é reexecutado automaticamente quando o valor do controle é alterado.

A caixa de diálogo desse construtor será chamada quando um procedimento armazenado for selecionado pela primeira vez como a fonte do registro de um formulário se esse procedimento tiver algum parâmetro. Após a criação inicial da sequência InputParameters, essa mesma caixa de diálogo será usada como um construtor para alterar a sequência. Nesse caso, no entanto, a lista de parâmetros vem do que já existe na string.

Os valores de parâmetro também são configuráveis no código usando os objetos Command e Parameter do Objeto de Dados ActiveX (ADO). Se o resultado retornar um conjunto de resultados, um formulário poderá ser associado a ele definindo a propriedade Recordset do formulário. A codificação ADO é a única maneira de lidar com procedimentos armazenados que não retornam conjuntos de resultados, como consultas de ação, aqueles que retornam parâmetros de saída ou aqueles que retornam vários conjuntos de resultados.

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.