Propriedade Report.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 fonte de registro em um projeto do Microsoft Access (.adp). String de leitura/gravação.

Sintaxe

expressão. Inputparameters

Expressão Uma variável que representa um objeto Report .

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 faria com que o parâmetro de estado fosse definido como o valor atual do controle StateList e o usuário sendo solicitado para 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 requery (por meio de menu, teclado ou barra de navegação) no Access deve disparar um reexecute da consulta. Os usuários podem fazer isso em 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 usada com um procedimento armazenado usaria a sintaxe a seguir.

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

Isso faria com que o @state parâmetro fosse definido como o valor atual do controle StateList e o usuário fosse solicitado para o @salesyear parâmetro. Se houvesse outros parâmetros para o procedimento armazenado que não estivessem nesta lista, eles receberiam 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 de atualização ou requery (por meio de menu, teclado ou barra de navegação) no Access deve disparar um reexecute do procedimento armazenado. Os usuários podem fazer isso em 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 cadeia de caracteres.

Os valores de parâmetro também são espetáveis no código usando os objetos De comando e parâmetro do ActiveX Data Object (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 do 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.