Propriedade InputParameters

Aplicável a

Objeto Form

Objeto Report

Você pode usar 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 usados como a fonte de registro dentro de um projeto do Microsoft Access (.adp). Cadeia de caracteres de Leitura/gravação de.

expressão.InputParameters

expressão Obrigatória. Uma expressão que retorna um dos objetos na lista Aplica-se a.

Comentários

Você pode definir essa propriedade usando folha de propriedades ou um código do Visual Basic for Applications (VBA).

Quando usado com uma propriedade RecordSource:

Um exemplo de cadeia de caracteres da propriedade InputParameter usado com uma instrução SQL na propriedade RecordSource usaria a seguinte sintaxe.

state char=[Forms]![formname]![StateList], salesyear smallint=[Forms]![formname]![Inserir ano relevante]

Isso resultará na configuração do parâmetro state como o valor atual do controle StateList, na solicitação do parâmetro salesyear ao usuário. Se houver outros parâmetros que não aparecem na lista, eles terão os valores padrão.

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

O comando de atualização ou repetição de consulta em Microsoft Office Access 2007 deve acionar uma nova execução da consulta. Os usuários podem fazer isso no código chamando o método padrão Recordset.Requery. Se o valor de um parâmetro estiver vinculado a um controle no formulário, o valor atual do controle será usado na nova consulta. A consulta não é reexecutada automaticamente quando o valor do controle mudar.

Quando usado com um procedimento armazenado:

Um exemplo de cadeia de caracteres de propriedade InputParameter usado com o procedimento armazenado seria:

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

Isso resultará na configuração do parâmetro @state como o valor atual do controle StateList, na solicitação do parâmetro @salesyear ao usuário. Se houver outros parâmetros para o proc armazenado que não aparecem na lista, eles terão os valores padrão.

O procedimento armazenado deve ser executado usando-se uma cadeia de caracteres de comando com a sintaxe {call } com um marcador ? para cada parâmetro não padrão na lista InputParameter.

O comando de atualização ou repetição de consulta no Access deve acionar uma nova execução do procedimento armazenado. Os usuários podem fazer isso no código chamando o método padrão Recordset.Requery. Se o valor de um parâmetro estiver vinculado a um controle no formulário, o valor atual do controle será usado na nova consulta. O procedimento armazenado não é reexecutada automaticamente quando o valor do controle mudar.

Esta caixa de diálogo de construtor é invocada quando um procedimento armazenado primeiro é selecionado como a fonte de registro de um formulário se procedimento armazenado tiver qualquer parâmetro. Após a criação de inicial da cadeia de caracteres InputParameters, essa mesma caixa de diálogo é usada como um construtor para se alterar a cadeia de caracteres. Nesse caso, entretanto, a lista de parâmetros vem do que já existe na cadeia de caracteres.

Os valores de parâmetro também serão configuráveis em código usando-se os objetos Command e Parameter do ActiveX Data Object (ADO). Se o resultado retornar um conjunto de resultados, um formulário poderá ser associado a ele definindo-se 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 ação, aqueles que retornam parâmetros de saída e aqueles que retornam os vários conjuntos de resultados.

Expanda suas habilidades no Office
Explore o treinamento
Obtenha novos recursos primeiro
Ingressar no Office Insider

Essas informações foram úteis?

Obrigado por seus comentários!

Agradecemos pelos seus comentários! Parece que pode ser útil conectar você a um de nossos agentes de suporte do Office.

×