Propriedade Report.InputParameters (Access)

Utilize a propriedade InputParameters para especificar ou determinar os parâmetros de entrada que são transmitidos para uma instrução SQL na propriedade OrigemDosRegistos de um formulário ou relatório ou um procedimento armazenado quando utilizados como origem de registos num projeto do Microsoft Access (.adp). String de leitura/gravação.

Sintaxe

expressão. InputParameters

expressão Uma variável que representa um objeto Relatório .

Comentários

Quando utilizado com uma propriedade OrigemDosRegistos

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]

Isto faria com que o parâmetro de estado fosse definido para o valor atual do controlo StateList e o utilizador fosse 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 predefinido na lista InputParameters .

Um comando de atualização ou repetição (através do menu, teclado ou barra de navegação) no Access deve acionar um reexecuto da consulta. Os utilizadores podem fazê-lo em código ao chamar 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 utilizado com um procedimento armazenado

Uma cadeia de propriedade InputParameters de exemplo utilizada com um procedimento armazenado utilizaria a seguinte sintaxe.

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

Isto faria com que o @state parâmetro fosse definido para o valor atual do controlo StateList e o utilizador fosse solicitado para o @salesyear parâmetro . Se houvesse outros parâmetros no procedimento armazenado que não estivessem nesta lista, obteriam valores predefinidos atribuídos.

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

Um comando de atualização ou repetição (através do menu, teclado ou barra de navegação) no Access deve acionar um reexecução do procedimento armazenado. Os utilizadores podem fazê-lo em código ao chamar 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. No entanto, neste caso, a lista de parâmetros provém do que já existe na cadeia.

Os valores dos parâmetros também são definidos em código através dos objetos Comando e Parâmetro do ActiveX Data Object (ADO). Se o resultado devolver um conjunto de resultados, um formulário pode ser vinculado ao mesmo ao definir a propriedade Conjunto de registos do formulário. A codificação ADO é a única forma de processar procedimentos armazenados que não devolvem conjuntos de resultados, como consultas de ação, aqueles que devolvem parâmetros de saída ou aqueles que devolvem 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.